SqlDataSourceEnumerator.GetDataSources Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.Sql

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

DataTable Pobiera informacje zawierające informacje o wszystkich widocznych wystąpieniach SQL Server.

public:
 override System::Data::DataTable ^ GetDataSources();

public override System.Data.DataTable GetDataSources ();

override this.GetDataSources : unit -> System.Data.DataTable

Public Overrides Function GetDataSources () As DataTable

Zwraca

DataTable

Zawiera DataTable informacje o widocznych wystąpieniach SQL Server.

Przykłady

Poniższa aplikacja konsolowa pobiera informacje o wszystkich widocznych wystąpieniach SQL Server i wyświetla informacje w oknie konsoli.

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("============================");  
    }  
  }  
} 

Uwagi

Tabela zwrócona przez tę metodę zawiera następujące kolumny, z których wszystkie zawierają ciągi:

Kolumna	Opis
ServerName	Nazwa serwera.
InstanceName	Nazwa wystąpienia serwera. Puste, jeśli serwer jest uruchomiony jako wystąpienie domyślne.
Isclustered	Wskazuje, czy serwer jest częścią klastra.
Wersja	Wersja serwera: 10.0.xx dla SQL Server 2008 r. 10.50.x dla SQL Server 2008 R2 11.0.xx dla SQL Server 2012 r. 12.0.xx dla SQL Server 2014 r. 13.0.xx dla SQL Server 2016 r. 14.0.xx dla SQL Server 2017 r.

Uwaga

Ze względu na charakter mechanizmu używanego przez SqlDataSourceEnumerator lokalizowanie źródeł danych w sieci metoda nie zawsze zwraca pełną listę dostępnych serwerów, a lista może nie być taka sama w każdym wywołaniu. Jeśli planujesz użyć tej funkcji, aby umożliwić użytkownikom wybranie serwera z listy, upewnij się, że zawsze podasz opcję, aby wpisać nazwę, która nie znajduje się na liście, w przypadku gdy wyliczenie serwera nie zwraca wszystkich dostępnych serwerów. Ponadto ta metoda może zająć dużo czasu, więc należy zachować ostrożność podczas wywoływania tej metody, gdy wydajność jest krytyczna.

Zobacz też

• Wyliczanie wystąpień SQL Server