Metodo SqlDataSourceEnumerator.GetDataSources (System.Data.Sql)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Metodo SqlDataSourceEnumerator.GetDataSources
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Recupera una classe DataTable contenente informazioni su tutte le istanze visibili di SQL Server 2000 o SQL Server 2005.

Spazio dei nomi:  System.Data.Sql
Assembly:  System.Data (in System.Data.dll)
Sintassi

Visual Basic
Public Overrides Function GetDataSources As DataTable
C#
public override DataTable GetDataSources()
Visual C++
public:
virtual DataTable^ GetDataSources() override
F#
abstract GetDataSources : unit -> DataTable 
override GetDataSources : unit -> DataTable 

Valore restituito

Tipo: System.Data.DataTable
Restituisce una classe DataTable contenente informazioni sulle istanze visibili di SQL Server.
Note

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 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.

Esempi

La seguente applicazione della console recupera informazioni su tutte le istanze visibili di SQL Server e visualizza le informazioni nella finestra della console.

Visual Basic
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
C#
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("============================");
    }
  }
}
Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1
Piattaforme

Windows 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.
Vedere anche

Riferimenti

Altre risorse