你当前正在访问 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 帐户。 免费创建帐户。
Visual Studio 2022 Community、Professional 或 Enterprise 版本。
可在其中运行查询的数据库。
可以根据下述快速入门之一,创建数据库,然后对其进行配置:
操作 SQL 数据库 SQL 托管实例 Azure VM 上的 SQL Server Azure Synapse Analytics 创建 Portal Portal 门户 门户 CLI CLI PowerShell PowerShell PowerShell PowerShell 部署模板 部署模板 部署模板 部署模板 配置 服务器级别 IP 防火墙规则 从 VM 进行连接 连接设置 来自本地的连接 连接到 SQL Server 实例 获取连接信息 Azure SQL Azure SQL SQL VM Synapse SQL
创建用于查询 Azure SQL 数据库中的数据库的代码
在 Visual Studio 中,创建新的项目。
在“新建项目”对话框中,选择“C# 控制台应用”。
输入“sqltest”作为项目名称,然后选择“下一步”。
选择一个“(长期支持)”框架选项(例如“.NET 6.0”),然后选择“创建”。 创建新项目。
选择“项目”>“管理 NuGet 包” 。
在“NuGet 包管理器”中,选择“浏览”选项卡,然后搜索并选择“Microsoft.Data.SqlClient” 。
在“Microsoft.Data.SqlClient”页上选择“安装” 。
- 如果出现提示,请选择“确定”继续安装。
- 如果显示“接受许可证”窗口,则选择“我接受” 。
安装完成后,可以关闭“NuGet 包管理器”。
在代码编辑器中,将 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(); } } }
运行代码
- 若要运行该应用,请选择“调试”>“开始调试”,或选择工具栏上的“开始”,或按 F5 。
- 验证是否返回了数据库名称和排序规则,然后关闭应用窗口。
后续步骤
- 了解如何在 Windows/Linux/macOS 上通过命令行使用 .NET 连接和查询 Azure SQL 数据库中的数据库。
- 了解在 Windows/Linux/macOS 中通过 VS Code 使用 .NET 入门。
- 详细了解如何使用 .NET 和 SQL 进行开发。
- 了解如何使用 SSMS 在 Azure SQL 数据库中设计你的第一个数据库。
- 有关 .NET 的详细信息,请参阅 .NET 文档。
- 重试逻辑示例:使用 ADO.NET 弹性连接到 Azure SQL。