SqlDataSourceEnumerator.GetDataSources Metode

Definisi

Ruang nama:

System.Data.Sql

Rakitan:

System.Data.dll

Mengambil informasi yang DataTable berisi tentang semua instans SQL Server yang terlihat.

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

Mengembalikan

DataTable

Berisi DataTable informasi tentang instans SQL Server yang terlihat.

Contoh

Aplikasi konsol berikut mengambil informasi tentang semua instans SQL Server yang terlihat dan menampilkan informasi di jendela konsol.

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

Keterangan

Tabel yang dikembalikan oleh metode ini berisi kolom berikut, yang semuanya berisi string:

Kolom	Deskripsi
ServerName	Nama server.
InstanceName	Nama instans server. Kosong jika server berjalan sebagai instans default.
IsClustered	Menunjukkan apakah server adalah bagian dari kluster.
Versi	Versi server: 10.0.xx untuk SQL Server 2008 10.50.x untuk SQL Server 2008 R2 11.0.xx untuk SQL Server 2012 12.0.xx untuk SQL Server 2014 13.0.xx untuk SQL Server 2016 14.0.xx untuk SQL Server 2017

Catatan

Karena sifat mekanisme yang digunakan oleh SqlDataSourceEnumerator untuk menemukan sumber data di jaringan, metode ini tidak akan selalu mengembalikan daftar lengkap server yang tersedia, dan daftarnya mungkin tidak sama pada setiap panggilan. Jika Anda berencana menggunakan fungsi ini untuk memungkinkan pengguna memilih server dari daftar, pastikan Anda selalu menyediakan opsi untuk mengetikkan nama yang tidak ada dalam daftar, jika enumerasi server tidak mengembalikan semua server yang tersedia. Selain itu, metode ini mungkin membutuhkan banyak waktu untuk dieksekusi, jadi berhati-hatilah untuk memanggilnya ketika performa sangat penting.

Lihat juga

• Menghitung Contoh SQL Server