Enumerazione di istanze di SQL Server (ADO.NET)
SQL Server consente alle applicazioni di trovare le istanze di SQL Server all'interno della rete corrente. La classe SqlDataSourceEnumerator espone queste informazioni allo sviluppatore di applicazioni, offrendo una classe DataTable che contiene informazioni su tutti i server visibili. La tabella restituita include un elenco di istanze di server disponibili in rete che corrisponde all'elenco fornito quando un utente tenta di creare una nuova connessione ed espande l'elenco a discesa contenente tutti i server disponibili nella finestra di dialogo Proprietà connessione. I risultati visualizzati non sono sempre completi.
Nota
Come per la maggior parte dei servizi di Windows, è preferibile eseguire il servizio SQL Browser con privilegi minimi.
Recupero di un'istanza di enumeratore
Per recuperare la tabella che contiene le informazioni sulle istanze di SQL Server disponibili, è prima necessario recuperare un enumeratore usando la proprietà condivisa/statica Instance:
Dim instance As System.Data.Sql.SqlDataSourceEnumerator = _
System.Data.Sql.SqlDataSourceEnumerator.Instance
System.Data.Sql.SqlDataSourceEnumerator instance =
System.Data.Sql.SqlDataSourceEnumerator.Instance
Dopo aver recuperato l'istanza statica, è possibile chiamare il metodo GetDataSources che restituisce una classe DataTable contenente informazioni sui server disponibili:
Dim dataTable As System.Data.DataTable = instance.GetDataSources()
System.Data.DataTable dataTable = instance.GetDataSources();
La tabella restituita dalla chiamata al metodo contiene le colonne seguenti, tutte contenenti valori string:
| Colonna | Descrizione |
|---|---|
| ServerName | Nome del server. |
| InstanceName | Nome dell'istanza del server. Vuota se il server è in esecuzione come istanza predefinita. |
| IsClustered | Indica se il server fa parte di un cluster. |
| Versione | Versione del server Ad esempio: - 9.00.x (SQL Server 2005) - 10.0.xx (SQL Server 2008) - 10.50.x (SQL Server 2008 R2) - 11.0.xx (SQL Server 2012) |
Limitazioni delle enumerazioni
È possibile che non siano elencati tutti i server disponibili. L'elenco può variare in base a fattori quali timeout e traffico di rete. Ciò può determinare elenchi diversi in due chiamate consecutive. Verranno elencati solo i server nella stessa rete. I pacchetti broadcast in genere non attraversano i router. Ecco perché è possibile che un server non sia visibile nell'elenco, ma sarà stabile tra le diverse chiamate.
È possibile che i server elencati non includano informazioni aggiuntive, ad esempio IsClustered e la versione. Questo dipende da come è stato ottenuto l'elenco. I server elencati tramite il servizio SQL Browser presenteranno maggiori dettagli rispetto a quelli rilevati tramite l'infrastruttura Windows, che elencherà solo i nomi.
Nota
L'enumerazione dei server è disponibile solo durante l'esecuzione in attendibilità totale. Gli assembly in esecuzione in un ambiente parzialmente attendibile non potranno usarla, anche se hanno l'autorizzazione CAS (sicurezza dall'accesso di codice) SqlClientPermission.
SQL Server fornisce informazioni per SqlDataSourceEnumerator tramite l'uso di un servizio Windows esterno denominato SQL Browser. Questo servizio è abilitato per impostazione predefinita, ma gli amministratori possono disattivarlo o disabilitarlo, rendendo invisibile l'istanza del server a questa classe.
Esempio
L'applicazione console seguente consente di recuperare informazioni su tutte le istanze di SQL Server visibili e di visualizzarle 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("============================");
}
}
}