.NET环境安装

开发.NET应用程序需要先安装.NET开发环境，YashanDB ADO.NET驱动要求的.NET版本如下：

• .NET 5.0
• .NET 6.0

对于Windows平台

Note:

目前仅支持Windows 10及以上版本。

1. 通过官方路径下载并安装适用于Windows的上述版本的.NET。
2. 安装Visual Studio或类似的集成开发环境来编写和编译C#源代码，本手册以Visual Studio为例进行介绍。
3. 运行dotnet --version验证.NET环境是否正常：

C:\>dotnet --version
6.0.301

C:\>

对于Linux平台

1. 通过官方路径下载并安装适用于Liunx的上述版本的.NET。
2. 运行dotnet --version验证.NET环境是否正常：

$ dotnet --version
6.0.301
$ 

安装依赖项

为了正确使用YashanDB ADO.NET驱动，还需要安装YashanDB C驱动客户端并设置环境变量，可自行选择当前或之前版本的YashanDB C驱动客户端使用。

对于Windows平台

1. 在产品软件包或安装目录的Drivers文件夹中，查找yashandb-c-版本号-win-x86_64.zip，例如yashandb-c-22.1-win-x86_64.zip。
2. 下载并解压到本地路径，如D:\yashandb\c。
3. 设置环境变量PATH，指向该文件路径下的lib文件夹。

对于Linux平台

1. 在产品软件包或安装目录的Drivers文件夹中，查找yashandb-c-版本号.tar.gz，例如yashandb-c-22.1-linux-x86_64.tar.gz。
2. 下载并解压到本地路径，如/opt/yashandb/c。
3. 设置环境变量。

export LD_LIBRARY_PATH=/opt/yashandb/c/lib:$LD_LIBRARY_PATH

YashanDB ADO.NET驱动包安装

1.在产品软件包或安装目录的Drivers文件夹中，查找yashandb-dotnet-版本号.zip，例如yashandb-dotnet-22.1.zip。

2.将压缩包下载并解压到本地路径，例如/path/Yashandb.Data.YashandbClient。

3.编辑应用程序项目，将Yashandb.Data.YashandbClient项目引用到该项目。本手册使用的项目文件示例为Examples，具体内容见YashanDB ADO.NET驱动使用示例章节描述。

对于在 Visual Studio 开发的应用程序

1. 打开应用程序项目Examples，点击“文件-添加-现有项目”，找到Yashandb.Data.YashandbClient所在路径，点击进去选择 Yashandb.Data.YashandbClient.csproj文件，将Yashandb.Data.YashandbClient加入到应用所在解决方案内。

   

2. 右键Examples应用程序项目，依次选择“添加 -> 项目引用 -> 项目”，找到 Yashandb.Data.YashandbClient 选项并勾选。

对于在命令行开发的.NET应用程序（以Linux环境为例）

1. 进入Examples应用程序项目所在文件夹，通过dotnet命令将Yashandb.Data.YashandbClient项目添加到该应用程序项目内。

 dotnet add reference /path/Yashandb.Data.YashandbClient/Yashandb.Data.YashandbClient.csproj

完成项目引用后，该应用程序即可进行对YashanDB数据库的访问操作。