列舉 SQL Server 執行個體 (ADO.NET)

發行項
05/10/2023

SQL Server 允許應用程式在目前網路內尋找 SQL Server 執行個體。 SqlDataSourceEnumerator 類別會向應用程式開發人員公開此資訊，並提供包含所有可見伺服器相關資訊的 DataTable。這個傳回的資料表包含網路上可用伺服器執行個體的清單 (該清單與使用者嘗試建立新連線時所提供的清單相符)，並展開包含 [連線屬性] 對話方塊上所有可用伺服器的下拉式清單。顯示的結果不一定完整。

注意

就像大多數的 Windows 服務一樣，最好以最少的可能權限來執行 SQL Browser 服務。

擷取列舉值執行個體

若要擷取包含可用 SQL Server 執行個體相關資訊的資料表，您必須先使用共用/靜態 Instance 屬性擷取列舉值：

Dim instance As System.Data.Sql.SqlDataSourceEnumerator = _  
   System.Data.Sql.SqlDataSourceEnumerator.Instance

System.Data.Sql.SqlDataSourceEnumerator instance =
   System.Data.Sql.SqlDataSourceEnumerator.Instance

一旦您擷取靜態執行個體之後，就可以呼叫 GetDataSources 方法，來傳回包含可用伺服器相關資訊的 DataTable：

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

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

從方法呼叫傳回的資料表會包含下列資料行，這些資料行全都包含 string 值：

資料行	描述
ServerName	伺服器的名稱。
InstanceName	伺服器執行個體的名稱。如果伺服器是以預設執行個體的形式執行，則為空白。
IsClustered	指出伺服器是否為叢集的一部分。
版本	伺服器的版本。例如： - 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 基礎結構找到的伺服器 (僅列出名稱)。

注意

只有在完全信任中執行時，才可以使用伺服器列舉。在部分信任的環境中執行的組件將無法使用它，即使它們具有 SqlClientPermission 程式碼存取安全性 (CAS) 權限也一樣。

SQL Server 可藉由使用名為 SQL Browser 的外部 Windows 服務來提供 SqlDataSourceEnumerator 相關資訊。此服務預設會啟用，但系統管理員可能會將其關閉或停用，讓此類別看不到伺服器執行個體。

範例

下列主控台應用程式會擷取所有可見 SQL Server 執行個體的相關資訊，並在主控台視窗中顯示該資訊。

Imports System.Data.Sql  
  
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 System.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("============================");  
    }  
  }  
}

另請參閱

SQL Server and ADO.NET (SQL Server 和 ADO.NET)
ADO.NET 概觀 \(部分機器翻譯\)

列舉 SQL Server 執行個體 (ADO.NET)

擷取列舉值執行個體

列舉型別限制

範例

另請參閱

其他資源