mirror of
https://github.com/taosdata/TDengine
synced 2026-05-24 10:09:01 +00:00
3.9 KiB
3.9 KiB
| toc_max_heading_level | sidebar_label | title |
|---|---|---|
| 4 | C# | C# Connector |
TDengine.Connector 是 TDengine 提供的 C# 语言连接器。C# 开发人员可以通过它开发存取 TDengine 集群数据的 C# 应用软件。
本文介绍如何在 Linux 或 Windows 环境中安装 TDengine.Connector，并通过 TDengine.Connector 连接 TDengine 集群，进行数据写入、查询等基本操作。
TDengine.Connector 的源码托管在 GitHub。
版本支持
请参考版本支持列表
安装步骤
安装前准备
安装 TDengine.Connector
通过 Nuget 增加TDengine.Connector包
dotnet add package TDengine.Connector
建立连接
{{#include docs/examples/csharp/cloud-example/connect/connect.csproj}}
{{#include docs/examples/csharp/cloud-example/connect/Program.cs}}
使用示例
基本插入和查询
{{#include docs/examples/csharp/cloud-example/usage/usage.csproj}}
{{#include docs/examples/csharp/cloud-example/usage/Program.cs}}
STMT 插入
{{#include docs/examples/csharp/cloud-example/stmt/stmt.csproj}}
{{#include docs/examples/csharp/cloud-example/stmt/Program.cs}}
重要更新记录
| TDengine.Connector | 说明 |
|---|---|
| 3.0.2 | 支持 .NET Framework 4.5 及以上，支持 .NET standard 2.0。Nuget Package 包含 WebSocket 动态库。 |
| 3.0.1 | 支持 WebSocket 和 Cloud，查询，插入，参数绑定。 |
| 3.0.0 | 支持 TDengine 3.0.0.0，不兼容 2.x。新增接口 TDengine.Impl.GetData()，解析查询结果。 |
| 1.0.7 | 修复 TDengine.Query() 内存泄露。 |
| 1.0.6 | 修复 schemaless 在 1.0.4 和 1.0.5 中失效 bug。 |
| 1.0.5 | 修复 Windows 同步查询中文报错 bug。 |
| 1.0.4 | 新增异步查询，订阅等功能。修复绑定参数 bug。 |
| 1.0.3 | 新增参数绑定、schemaless、json tag 等功能。 |
| 1.0.2 | 新增连接管理、同步查询、错误信息等功能。 |
其他说明
第三方驱动
IoTSharp.Data.Taos 是一个 TDengine 的 ADO.NET 连接器，其中包含了用于 EntityFrameworkCore 的提供程序 IoTSharp.EntityFrameworkCore.Taos 和健康检查组件 IoTSharp.HealthChecks.Taos，支持 Linux，Windows 平台。该连接器由社区贡献者麦壳饼@@maikebing 提供，具体请参考：
常见问题
- "Unable to establish connection"，"Unable to resolve FQDN"
一般是因为 FQDN 配置不正确。可以参考如何彻底搞懂 TDengine 的 FQDN解决。
- Unhandled exception. System.DllNotFoundException: Unable to load DLL 'taos' or one of its dependencies: 找不到指定的模块。
一般是因为程序没有找到依赖的客户端驱动。解决方法为：Windows 下可以将 C:\TDengine\driver\taos.dll 拷贝到 C:\Windows\System32\ 目录下，Linux 下建立如下软链接 ln -s /usr/local/taos/driver/libtaos.so.x.x.x.x /usr/lib/libtaos.so 即可。