Lingua
Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
SQL Server consente alle applicazioni di trovare istanze di SQL Server all'interno della rete corrente. La SqlDataSourceEnumerator classe restituisce i server visibili nell'oggetto DataTable . Nella tabella sono elencate le istanze del server disponibili nella rete, ad esempio l'elenco dei server nella finestra di dialogo Proprietà connessione . I risultati non sono sempre completi.
Con Microsoft.Data.SqlClient, GetDataSources richiede Windows con rete nativa. In Linux, macOS o Windows con rete gestita abilitata, il metodo genera NotImplementedException. In questi ambienti specificare l'indirizzo del server e la porta direttamente nella stringa di connessione invece del rilevamento del server.
Annotazioni
Come per la maggior parte dei servizi Windows, è consigliabile eseguire il servizio SQL Browser con i privilegi minimi possibili.
Recupero di un'istanza dell'enumeratore
Per recuperare informazioni sulle istanze di SQL Server disponibili, recuperare innanzitutto un enumeratore con la proprietà condivisa/staticaInstance:
Dim instance As Microsoft.Data.Sql.SqlDataSourceEnumerator = _
Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance
Microsoft.Data.Sql.SqlDataSourceEnumerator instance =
Microsoft.Data.Sql.SqlDataSourceEnumerator.Instance;
Dopo aver recuperato l'istanza statica, chiamare GetDataSources per recuperare informazioni sui server disponibili nell'oggetto DataTable :
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 string valori:
| colonna | Descrizione |
|---|---|
ServerName |
Nome del server. |
InstanceName |
Nome dell'istanza del server. Vuoto se il server è in esecuzione come istanza predefinita. |
IsClustered |
Indica se il server fa parte di un cluster. |
Version |
Versione del server. Per 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 dell'enumerazione
Tutti i server disponibili possono essere elencati o meno. L'elenco può variare a seconda di fattori quali timeout e traffico di rete. In questo modo l'elenco può essere diverso in due chiamate consecutive. Verranno elencati solo i server nella stessa rete. I pacchetti di trasmissione in genere non attraversano i router, motivo per cui potrebbe non essere visualizzato un server elencato, ma sarà stabile tra le chiamate.
I server elencati possono avere o meno informazioni aggiuntive, ad IsClustered esempio e versione. Questo dipende dal modo in cui è stato ottenuto l'elenco. I server elencati tramite il servizio browser DI SQL Server avranno maggiori dettagli rispetto a quelli trovati tramite l'infrastruttura di Windows, che elenca solo il nome.
Annotazioni
Il moderno .NET non supporta Code Access Security o l'esecuzione a attendibilità parziale. Per l'individuazione del server, consentire il traffico di rete SQL Server Browser necessario.
SQL Server fornisce informazioni per il SqlDataSourceEnumerator tramite il servizio Windows esterno SQL Browser. Questo servizio è abilitato per impostazione predefinita, ma gli amministratori potrebbero disattivarlo o disabilitarlo, rendendo l'istanza del server invisibile a questa classe.
Esempio
L'applicazione console seguente recupera informazioni sulle istanze visibili SQL Server e visualizza le informazioni nella finestra della console. Installare il pacchetto NuGet Microsoft.Data.SqlClient.
Imports Microsoft.Data.Sql
Imports System.Data
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 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("============================");
}
}
}