Visual Studio 新建项目 C# 连接 SQL Server 查询测试连接字符串写法

Bertha 。 2023-01-19 09:48 98阅读 0赞

### 文章目录 ###

*   *  Intro
     *  Operation
     *  C\# 连接 SQL Server 相关 API
     *  连接字符串的写法，各个字段的意义
     *  运行截图

## Intro ##

程序员使用`编程语言`，将实际需要执行的`数据读写操作`基于`数据库系统`提前编写为各类用户可使用的软件。

免不了要在`编程语言`与`数据库`之间做对接(测试)。

本次测试使用`C#`连接`SQL Server`，并做查询测试，环境如下：

*  操作系统： Windows 10 pro
 *  数据库系统： SQL Server 2008 R2 (SP2)
 *  IDE： Visual Studio Community 2019
 *  编程语言：C\#
 *  依赖管理工具： NuGet
 *  数据库连接依赖(library)： [System.Data.SqlClient 4.8.2][]

## Operation ##

启动 Visual Studio

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center]【创建新项目】

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 1]  
新建【控制台应用程序】(只是测试数据库连接，只用命令行就可以。当然也可以新建 .net mvc 项目)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 2]  
输入要新建项目的项目名

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 3]  
选择【目标框架】

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 4]  
会生成默认的项目结构(见右侧`解决方案查看器`)，以及一个代码文件`Program.cs`。  
Run 运行方式：`调试 - 开始执行(不调试)`  
Debug 调试方式：`调试 - 开始调试`

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 5]运行结果：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 6]

## C\# 连接 SQL Server 相关 API ##

就像JDBC一样，使用数据库连接信息(数据库服务器地址，用户名/密码)创建连接，准备请求对象，做读写操作，处理结果集。

因为只是为了测试`连接字符串`的写法，以及数据库是否成功连接(通过一次查询动作可以确定)，所以不做过多的封装(否则对第一次做连接测试的普通人来说反而过于晦涩)，直接**面向过程**编程。

using System;
    using System.Data;
    using System.Data.SqlClient;
    
    namespace SqlServerConnectDemo
    {
        class Program
        {
            static void Main(string[] args)
            {
                Console.WriteLine("程序运行开始");
                //string connStr = "Data Source=yujin-win10pro;Database = wyj;User Id = sa;Password = sa;";
                //string connStr = "Server=localhost;Database=wyj;Trusted_Connection=True;";
                string connStr = "Server=yujin-win10pro;Database=wyj;Trusted_Connection=True;";
                string sql = "select id, name from wyj..tb_person";
                SqlConnection conn = null;
                try
                {
                    conn = new SqlConnection(connStr);
                    SqlCommand cmd = new SqlCommand(sql, conn);
                    SqlDataAdapter adapter = new SqlDataAdapter(cmd);
                    SqlCommandBuilder build = new SqlCommandBuilder(adapter);
    
                    DataSet dataSet = new DataSet();
                    adapter.Fill(dataSet);
    
                    DataTable resultTable = dataSet.Tables[0];
                    Console.WriteLine("查询成功，即将遍历：" + resultTable);
                    foreach (DataRow row in resultTable.Rows)
                    {
                        foreach (DataColumn rowColumn in dataSet.Tables[0].Columns)
                        {
                            Console.Write(row[rowColumn].ToString() + "\t");
                        }
                        Console.WriteLine();
                    }
                }
                catch (Exception e) 
                {
                    Console.WriteLine("查询失败：" + e.Message);
                }
                finally
                {
                    if (conn != null)
                    {
                        conn.Close();
                    }
                }
                Console.WriteLine("程序运行结束");
            }
        }
    }

其中的`using System.Data.SqlClient;`依赖以下类库： System.Data.SqlClient，  
介绍页：[https://www.nuget.org/packages/System.Data.SqlClient/4.8.2?\_src=template][System.Data.SqlClient 4.8.2]

如果**还没有配置好该依赖库**(其实就是`System.Data.SqlClient.dll`文件)，会报错：  
![在这里插入图片描述][20210515114533490.png_pic_center]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 7]以上是没有配置依赖，且没有`using System.Data.SqlClient;`的情况。

添加`using System.Data.SqlClient;`后，报错如下：  
![在这里插入图片描述][20210515114628117.png_pic_center]

【`添加 System.Data.SqlClient.dll 依赖到本项目`】后：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 8]  
如果对 使用 NuGet 下载依赖 的方法有疑问，  
见：[Visual Studio 中配置 依赖管理工具 NuGet 并搜索下载所需依赖 全流程截图][Visual Studio _ _ NuGet _]

## 连接字符串的写法，各个字段的意义 ##

本例中测试了三种写法，都可以成功执行。

string connStr = "Data Source=yujin-win10pro;Database = wyj;User Id = sa;Password= sa;";
    //string connStr = "Server=localhost;Database=wyj;Trusted_Connection=True;";
    //string connStr = "Server=yujin-win10pro;Database=wyj;Trusted_Connection=True;";

*  字段意义
    
     *  `Serever`: 表示要连接的**SQL Server 服务端所在的机器**(可以是ip, 可以是hostname)，我的是在本地安装，所以localhost也可以用于定位。
     *  `Database`: 数据库，别名
     *  `User Id`: 用户名
     *  `Password`: 密码

关于参数`Server`，它有几个别名：`Address, Addr, Data Source, Network Address`。  
而`Database`的别名：`Initial Catalog`  
`User Id`别名：`UID`  
`Password`的别名：`PWD`

至于 `Trusted_Connection=True;`，在测试连接阶段，这个参数无关紧要。

其他的连接字符串参数见：  
见 [https://docs.microsoft.com/en-us/dotnet/api/system.data.sqlclient.sqlconnection.connectionstring?view=dotnet-plat-ext-5.0][https_docs.microsoft.com_en-us_dotnet_api_system.data.sqlclient.sqlconnection.connectionstring_view_dotnet-plat-ext-5.0]

## 运行截图 ##

*  数据库环境准备

首先，因为我测试的SQL为`select * from wyj..tb_person;`，所以要确保数据库里有对应的库、表、几行测试数据。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 9]脚本：

create database wyj;
    
    use wyj;
    go
    
    create table tb_person (
    	id int,
    	name nvarchar(20)
    );
    
    
    insert into wyj..tb_person (id, name) values 
    (1, 'one'),
    (2, 'two'),
    (3, 'three'),
    (4, 'four');
    
    select * from wyj..tb_person;

*  项目概览

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 10]

*  调试查看结果

Debug  
鼠标移动至`DataSet`类型的变量`resultTable`上方，点击悬浮窗中的小放大镜，可以看到`DataSet 可视化工具`。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 11]  
或由代码便利返回的对象：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 12]

[System.Data.SqlClient 4.8.2]: https://www.nuget.org/packages/System.Data.SqlClient/4.8.2?_src=template
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center]: /images/20221021/12edcc14e9dd497180022b7c75c98c94.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221021/2a32c74378824a6baafb34f10cd3b51c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221021/edd726dd08dc4015becb3811f556880e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221021/15afb07adb4d44f1adaa5584e2c4c755.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221021/698760e6b5a0447bbbe0bceaff8faaa1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221021/7d55d2b34f9d4d6ea1e53951d00d03dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221021/1d366ecbfc66459abd7c58bbc6732b62.png
[20210515114533490.png_pic_center]: /images/20221021/2491dc8897b8487e9aa76e839020cae7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221021/1e85736348d140a6bd30cdb00d2d15a5.png
[20210515114628117.png_pic_center]: /images/20221021/4f01084308a445a7953c43c17b438c2a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221021/f0522bb2c6944bd0be280e71a27665b0.png
[Visual Studio _ _ NuGet _]: https://wuyujin.blog.csdn.net/article/details/116842768
[https_docs.microsoft.com_en-us_dotnet_api_system.data.sqlclient.sqlconnection.connectionstring_view_dotnet-plat-ext-5.0]: https://docs.microsoft.com/en-us/dotnet/api/system.data.sqlclient.sqlconnection.connectionstring?view=dotnet-plat-ext-5.0
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221021/9427095a8927428983afac52a292e1be.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221021/8afd1993284844afbb3b85d57297afc0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 11]: /images/20221021/5fb58609677e4211ac6883f6d8558ea2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1eXVqaW4xOTk3_size_16_color_FFFFFF_t_70_pic_center 12]: /images/20221021/81b9fd6a2fb54b28a0f6199e8311957c.png