語言

列舉 SQL Server 實例 (ADO.NET)

SQL Server 允許應用程式在目前網路中尋找 SQL Server 實例。 該 SqlDataSourceEnumerator 類別回傳 DataTable 物件中的可見伺服器。 表格列出網路上可用的伺服器實例,類似 連線內容 對話框中的伺服器清單。 結果並不總是完整的。

使用 Microsoft.Data.SqlClient 時,GetDataSources 需要具備原生網路功能的 Windows。 在 Linux、macOS 或啟用管理網路的 Windows 上,該方法會拋出NotImplementedException。 在這些環境下,直接在 連接字串 裡指定伺服器位址和埠口,而不要使用伺服器探索機制。

備註

和大多數 Windows 服務一樣,最好以最少的許可權執行 SQL Browser 服務。

擷取列舉器實例

若要取得可用 SQL Server 執行個體的資訊,請先透過共用/靜態 Instance 屬性取得列舉程式:

Dim instance As Microsoft.Data.Sql.SqlDataSourceEnumerator = _
   Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance
Microsoft.Data.Sql.SqlDataSourceEnumerator instance =
   Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance;

取得靜態實例後,呼叫 GetDataSources 以取得 DataTable 物件中可用伺服器的資訊:

Dim dataTable As System.Data.DataTable = instance.GetDataSources()
System.Data.DataTable dataTable = instance.GetDataSources();

從方法呼叫傳回的數據表包含下列數據行,這些數據行都包含 string 值:

資料行 說明
ServerName 伺服器的名稱。
InstanceName 伺服器實例的名稱。 如果伺服器以預設實例的形式執行,則為空白。
IsClustered 指出伺服器是否為叢集的一部分。
Version 伺服器的版本。 例如:

- 9.00.x (SQL Server 2005)
- 10.0.xx (SQL Server 2008)
- 10.50.x (SQL Server 2008 R2)
- 11.0.xx (SQL Server 2012)

列舉限制

所有可用的伺服器都可能或可能不會列出。 清單可能會因逾時和網路流量等因素而有所不同。 這可能會導致清單在連續兩次呼叫時不同。 只會列出相同網路上的伺服器。 廣播封包通常不會周遊路由器,這就是為什麼您可能看不到列出的伺服器,但它會在呼叫之間穩定。

列出的伺服器可能或可能沒有其他資訊,例如 IsClustered 和 版本。 這取決於取得清單的方式。 透過 SQL Server 瀏覽器服務列出的伺服器會比透過 Windows 基礎結構找到的伺服器擁有更多詳細數據,而 Windows 基礎結構只會列出名稱。

備註

現代 .NET 不支援程式碼存取安全或部分信任執行。 為了探索伺服器,允許所需的 SQL Server 瀏覽器網路流量。

SQL Server 透過外部 Windows 服務 SQL 瀏覽器為 SqlDataSourceEnumerator 提供資訊。 此服務預設啟用,但管理員可能會關閉或停用,使伺服器實例對此類別隱形。

範例

以下主控台應用程式會擷取可見的 SQL Server 實例資訊,並在主控台視窗中顯示相關資訊。 安裝 Microsoft.Data.SqlClient NuGet 套件。

Imports Microsoft.Data.Sql
Imports System.Data

Module Module1
  Sub Main()
    ' Retrieve the enumerator instance and then the data.
    Dim instance As SqlDataSourceEnumerator = _
     SqlDataSourceEnumerator.Instance
    Dim table As System.Data.DataTable = instance.GetDataSources()

    ' Display the contents of the table.
    DisplayData(table)

    Console.WriteLine("Press any key to continue.")
    Console.ReadKey()
  End Sub

  Private Sub DisplayData(ByVal table As DataTable)
    For Each row As DataRow In table.Rows
      For Each col As DataColumn In table.Columns
        Console.WriteLine("{0} = {1}", col.ColumnName, row(col))
      Next
      Console.WriteLine("============================")
    Next
  End Sub
End Module
using Microsoft.Data.Sql;

class Program
{
  static void Main()
  {
    // Retrieve the enumerator instance and then the data.
    SqlDataSourceEnumerator instance =
      SqlDataSourceEnumerator.Instance;
    System.Data.DataTable table = instance.GetDataSources();

    // Display the contents of the table.
    DisplayData(table);

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
  }

  private static void DisplayData(System.Data.DataTable table)
  {
    foreach (System.Data.DataRow row in table.Rows)
    {
      foreach (System.Data.DataColumn col in table.Columns)
      {
        Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);
      }
      Console.WriteLine("============================");
    }
  }
}

另請參閱