SqlDataSourceEnumerator.GetDataSources Metoda

Definicja

Przestrzeń nazw:

System.Data.Sql

Zestaw:

System.Data.dll

Pobiera zawierające DataTable 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

Element DataTable zawierający 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.

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

Uwagi

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

Kolumna	Opis
Nazwa_serwera	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 10.50.x dla SQL Server 2008 R2 11.0.xx dla SQL Server 2012 12.0.xx dla SQL Server 2014 13.0.xx dla SQL Server 2016 14.0.xx dla SQL Server 2017

Uwaga

Ze względu na charakter mechanizmu używanego przez SqlDataSourceEnumerator program do lokalizowania ź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 należy podać opcję wpisania nazwy, która nie znajduje się na liście, jeśli wyliczenie serwera nie zwraca wszystkich dostępnych serwerów. Ponadto wykonanie tej metody może zająć znaczną ilość czasu, dlatego należy zachować ostrożność podczas wywoływania jej, gdy wydajność jest krytyczna.

Zobacz też

• Wyliczanie wystąpień SQL Server