SqlDataSourceEnumerator.GetDataSources Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte DataTable informace obsahující všechny viditelné SQL Server instance.
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
Návraty
Obsahuje DataTable informace o viditelných SQL Server instancích.
Příklady
Následující konzolová aplikace načte informace o všech viditelných SQL Server instancích a zobrazí je v okně konzoly.
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("============================");
}
}
}
Poznámky
Tabulka vrácená touto metodou obsahuje následující sloupce, z nichž všechny obsahují řetězce:
Sloupec | Popis |
---|---|
Název_serveru | Název serveru. |
InstanceName | Název instance serveru. Prázdné, pokud server běží jako výchozí instance. |
IsClustered | Označuje, jestli je server součástí clusteru. |
Verze | Verze serveru: 10.0.xx pro SQL Server 2008 10.50.x pro SQL Server 2008 R2 11.0.xx pro SQL Server 2012 12.0.xx pro SQL Server 2014 13.0.xx pro SQL Server 2016 14.0.xx pro SQL Server 2017 |
Poznámka
Vzhledem k povaze mechanismu, který SqlDataSourceEnumerator používá k vyhledání zdrojů dat v síti, metoda nevrátí vždy úplný seznam dostupných serverů a seznam nemusí být při každém volání stejný. Pokud chcete pomocí této funkce umožnit uživatelům vybrat server ze seznamu, ujistěte se, že vždy zadáte možnost zadat název, který není v seznamu, pro případ, že výčet serveru nevrátí všechny dostupné servery. Kromě toho může provedení této metody trvat značné množství času, takže při jejím volání buďte opatrní, pokud je výkon kritický.