SqlDataSourceEnumerator.GetDataSources Método

Definição

Espaço de Nomes:
System.Data.Sql
Assemblagem:
System.Data.dll

Recupera um DataTable contendo informações sobre todas as instâncias SQL Server visíveis.

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

Devoluções

DataTable

Um DataTable contendo informações sobre as instâncias SQL Server visíveis.

Exemplos

A aplicação de consola seguinte recolhe informações sobre todas as instâncias visíveis do SQL Server e apresenta a informação na janela da consola.

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

Observações

A tabela devolvida por este método contém as seguintes colunas, todas contendo cadeias:

Column Descrição
ServerName Nome do servidor.
Nome da instância Nome da instância do servidor. Em branco se o servidor estiver sendo executado como instância padrão.
IsClustered Indica se o servidor faz parte de um cluster.
Version Versão do servidor:

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

Observação

Devido à natureza do mecanismo utilizado SqlDataSourceEnumerator para localizar fontes de dados numa rede, o método nem sempre devolverá uma lista completa dos servidores disponíveis, e a lista pode não ser a mesma em todas as chamadas. Se planeia usar esta função para permitir que os utilizadores selecionem um servidor a partir de uma lista, certifique-se de que também fornece sempre uma opção para digitar um nome que não esteja na lista, caso a enumeração do servidor não devolva todos os servidores disponíveis. Além disso, este método pode demorar bastante tempo a ser executado, por isso tenha cuidado ao chamá-lo quando o desempenho for crítico.

Aplica-se a

Ver também