你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

快速入门:使用 Visual Studio 中的 .NET 和 C# 来连接和查询数据库

适用于: Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics

本快速入门展示了如何使用 Visual Studio 中的 .NET 和 C# 代码通过 Transact-SQL 语句查询 Azure SQL 或 Synapse SQL 中的数据库。

先决条件

若要完成本快速入门,你需要:

创建用于查询 Azure SQL 数据库中的数据库的代码

  1. 在 Visual Studio 中,创建新的项目。

  2. 在“新建项目”对话框中,选择“C# 控制台应用”。

  3. 输入“sqltest”作为项目名称,然后选择“下一步”。

  4. 选择一个“(长期支持)”框架选项(例如“.NET 6.0”),然后选择“创建”。 创建新项目。

  5. 选择“项目”>“管理 NuGet 包” 。

  6. 在“NuGet 包管理器”中,选择“浏览”选项卡,然后搜索并选择“Microsoft.Data.SqlClient” 。

  7. 在“Microsoft.Data.SqlClient”页上选择“安装” 。

    • 如果出现提示,请选择“确定”继续安装。
    • 如果显示“接受许可证”窗口,则选择“我接受” 。
  8. 安装完成后,可以关闭“NuGet 包管理器”。

  9. 在代码编辑器中,将 Program.cs 内容替换为以下代码。 替换 <your_server><your_username><your_password><your_database> 的值。

    using System;
    using Microsoft.Data.SqlClient;
    using System.Text;
    
    namespace sqltest
    {
        class Program
        {
            static void Main(string[] args)
            {
                try 
                { 
                    SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
                    builder.DataSource = "<your_server>.database.windows.net"; 
                    builder.UserID = "<your_username>";            
                    builder.Password = "<your_password>";     
                    builder.InitialCatalog = "<your_database>";
    
                    using (SqlConnection connection = new SqlConnection(builder.ConnectionString))
                    {
                        Console.WriteLine("\nQuery data example:");
                        Console.WriteLine("=========================================\n");
    
                        String sql = "SELECT name, collation_name FROM sys.databases";
    
                        using (SqlCommand command = new SqlCommand(sql, connection))
                        {
                            connection.Open();
                            using (SqlDataReader reader = command.ExecuteReader())
                            {
                                while (reader.Read())
                                {
                                    Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1));
                                }
                            }
                        }                    
                    }
                }
                catch (SqlException e)
                {
                    Console.WriteLine(e.ToString());
                }
                Console.ReadLine();
            }
        }
    }
    

运行代码

  1. 若要运行该应用,请选择“调试”>“开始调试”,或选择工具栏上的“开始”,或按 F5 。
  2. 验证是否返回了数据库名称和排序规则,然后关闭应用窗口。

后续步骤