SqlDataSourceEnumerator.GetDataSources Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen DataTable ab, der Informationen zu allen sichtbaren SQL Server Instanzen enthält.
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
Gibt zurück
Ein DataTable mit Informationen zu den sichtbaren SQL Server Instanzen.
Beispiele
Die folgende Konsolenanwendung ruft Informationen zu allen sichtbaren SQL Server Instanzen ab und zeigt die Informationen im Konsolenfenster an.
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("============================");
}
}
}
Hinweise
Die von dieser Methode zurückgegebene Tabelle enthält die folgenden Spalten, die alle Zeichenfolgen enthalten:
| Column | Description |
|---|---|
| ServerName | Name des Servers. |
| InstanceName | Name der Serverinstanz. Leer, wenn der Server als Standardinstanz ausgeführt wird. |
| IsClustered | Gibt ab, ob die Serverinstanz zu einem Cluster gehört. |
| Version | Version des Servers: 10.0.xx für SQL Server 2008 10.50.x für SQL Server 2008 R2 11.0.xx für SQL Server 2012 12.0.xx für SQL Server 2014 13.0.xx für SQL Server 2016 14.0.xx für SQL Server 2017 |
Note
Aufgrund der Art des Mechanismus, der verwendet SqlDataSourceEnumerator wird, um Datenquellen in einem Netzwerk zu finden, gibt die Methode nicht immer eine vollständige Liste der verfügbaren Server zurück, und die Liste ist möglicherweise bei jedem Aufruf nicht identisch. Wenn Sie beabsichtigen, diese Funktion zu verwenden, um Benutzern die Auswahl eines Servers aus einer Liste zu ermöglichen, stellen Sie sicher, dass Sie immer auch eine Option angeben, um einen Namen einzugeben, der nicht in der Liste enthalten ist, falls die Serveraufzählung nicht alle verfügbaren Server zurückgibt. Darüber hinaus kann diese Methode eine erhebliche Zeit in Anspruch nehmen, um sie auszuführen. Achten Sie daher darauf, sie aufzurufen, wenn die Leistung kritisch ist.