快速入門：在 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 Database	SQL 受控執行個體	Azure VM 上的 SQL Server	Azure Synapse Analytics
  建立	入口網站	入口網站	入口網站	入口網站
  	CLI			CLI
  	PowerShell	PowerShell	PowerShell	PowerShell
  	部署範本	部署範本	部署範本	部署範本
  設定	伺服器層級 IP 防火牆規則	VM 的連線能力		連線能力設定
  		來自內部部署的連線	連線到 SQL Server 執行個體
  取得連線資訊	Azure SQL	Azure SQL	SQL VM	Synapse SQL

建立查詢 Azure SQL Database 中資料庫的程式碼

1. 在 Visual Studio 中，建立新專案。

2. 在 [新增專案] 對話方塊中，選取 [C# 主控台應用程式]。

3. 輸入專案名稱 sqltest，然後選取 [確定]。

4. 選取 (長期支援) Framework 選項，例如 [.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. 確認已傳回資料庫名稱和定序，然後關閉應用程式視窗。

後續步驟

• 了解如何在 Windows/Linux/macOS 上，從命令列使用 .NET 連線和查詢 Azure SQL Database 中的資料庫。
• 了解使用 VS Code 開始在 Windows/Linux/macOS 上使用 .NET。
• 深入了解使用 .NET 和 SQL 進行開發。
• 了解如何使用 SSMS 在 Azure SQL Database 中設計您的第一個資料庫。
• 如需 .NET 的詳細資訊，請參閱 .NET 文件。
• 重試邏輯範例：使用 ADO.NET 復原連線到 Azure SQL。