Recupera una classe DataTable contenente informazioni su tutte le istanze visibili di SQL Server 2000 o SQL Server 2005.
Assembly: System.Data (in System.Data.dll)
Public Overrides Function GetDataSources As DataTable
public override DataTable GetDataSources()
public: virtual DataTable^ GetDataSources() override
abstract GetDataSources : unit -> DataTable override GetDataSources : unit -> DataTable
Valore restituito
Tipo: System.Data.DataTableRestituisce una classe DataTable contenente informazioni sulle istanze visibili di SQL Server.
La tabella restituita da questo metodo contiene le colonne elencate di seguito (tutte le colonne contengono stringhe):
|
Column |
Oggetto di descrizione |
|---|---|
|
ServerName |
Nome del server. |
|
InstanceName |
Nome dell'istanza del server. La colonna non contiene informazioni se il server viene eseguito come istanza predefinita. |
|
IsClustered |
Indica se il server è incluso in un cluster. |
|
Versione |
Versione del server (8.00.x per SQL Server 2000 e 9.00.x per SQL Server 2005). |
Nota
|
|---|
|
Per le caratteristiche del meccanismo utilizzato dal metodo SqlDataSourceEnumerator per individuare le origini dati nelle reti, in alcuni casi questo metodo non restituisce un elenco completo dei server disponibili oppure l'elenco potrebbe non essere identico in ciascuna chiamata. Se si prevede di utilizzare questa funzione per consentire agli utenti di selezionare un server da un elenco, includere sempre un'opzione che consenta di immettere il nome di un server non incluso nell'elenco, nel caso in cui l'enumerazione non restituisca tutti i server disponibili. Questo metodo, inoltre, può richiedere una notevole quantità di tempo per l'esecuzione. Pertanto, nei casi in cui le prestazioni rappresentano un fattore critico considerare attentamente l'opportunità di chiamare il metodo. |
La seguente applicazione della console recupera informazioni su tutte le istanze visibili di SQL Server e visualizza le informazioni nella finestra della console.
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("============================"); } } }
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0.NET Framework Client Profile
Supportato in: 4, 3.5 SP1Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Nota