SqlDataSourceEnumerator.GetDataSources Methode

Definitie

Naamruimte:
System.Data.Sql
Assembly:
System.Data.dll

Hiermee haalt u een DataTable met informatie over alle zichtbare SQL Server exemplaren op.

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

Retouren

DataTable

Een DataTable met informatie over de zichtbare SQL Server exemplaren.

Voorbeelden

De volgende consoletoepassing haalt informatie op over alle zichtbare SQL Server exemplaren en geeft de informatie weer in het consolevenster.

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("============================");
    }
  }
}

Opmerkingen

De tabel die door deze methode wordt geretourneerd, bevat de volgende kolommen, die allemaal tekenreeksen bevatten:

Column Beschrijving
Servernaam Naam van de server.
InstanceName Naam van de serverinstantie. Leeg als de server draait als de standaardinstantie.
IsClustered Geeft aan of de server deel uitmaakt van een cluster.
Versie Versie van de server:

10.0.xx voor SQL Server 2008
10.50.x voor SQL Server 2008 R2
11.0.xx voor SQL Server 2012
12.0.xx voor SQL Server 2014
13.0.xx voor SQL Server 2016
14.0.xx voor SQL Server 2017

Note

Vanwege de aard van het mechanisme dat wordt SqlDataSourceEnumerator gebruikt om gegevensbronnen in een netwerk te vinden, retourneert de methode niet altijd een volledige lijst met de beschikbare servers en is de lijst mogelijk niet hetzelfde voor elke aanroep. Als u van plan bent deze functie te gebruiken om gebruikers een server in een lijst te laten selecteren, moet u ervoor zorgen dat u altijd ook een optie opgeeft om een naam in te voeren die niet in de lijst staat, voor het geval de opsomming van de server niet alle beschikbare servers retourneert. Bovendien kan deze methode een aanzienlijke hoeveelheid tijd in beslag nemen om uit te voeren, dus wees voorzichtig met het aanroepen van deze methode wanneer de prestaties essentieel zijn.

Van toepassing op

Zie ook

  • Exemplaren van SQL Server