SqlDataSourceEnumerator.GetDataSources Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Informasi DataTable yang berisi 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.
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("============================");
}
}
}
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 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.