Biblioteca de clases de .NET Framework
SqlDataSourceEnumerator.GetDataSources (Método)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Recupera un objeto DataTable que contiene información sobre todas las instancias visibles de SQL Server 2000 o SQL Server 2005.

Espacio de nombres: System.Data.Sql
Ensamblado: System.Data (en system.data.dll)

Sintaxis

Visual Basic (Declaración)
Public Overrides Function GetDataSources As DataTable
Visual Basic (Uso)
Dim instance As SqlDataSourceEnumerator
Dim returnValue As DataTable

returnValue = instance.GetDataSources
C#
public override DataTable GetDataSources ()
C++
public:
virtual DataTable^ GetDataSources () override
J#
public DataTable GetDataSources ()
JScript
public override function GetDataSources () : DataTable

Valor devuelto

Devuelve un objeto DataTable que contiene información sobre las instancias visibles de SQL Server.
Comentarios

La tabla que devuelve este método contiene las columnas siguientes, todas con cadenas:

Columna

Descripción

ServerName

Nombre del servidor.

InstanceName

Nombre de la instancia de servidor. Queda en blanco si el servidor que se ejecuta es la instancia predeterminada.

IsClustered

Indica si el servidor forma parte de un clúster.

Version

Versión del servidor (8.00.x para SQL Server 2000 y 9.00.x para SQL Server 2005).

NotaNota

Por la naturaleza del mecanismo que utiliza >SqlDataSourceEnumerator para localizar los orígenes de datos en una red, el método no devolverá siempre una lista completa de servidores disponibles y la lista que podría ser distinta en cada llamada. Si tiene pensado utilizar esta función para permitir que los usuarios seleccionen un servidor de una lista, asegúrese de proporcionar también la opción de escribir un nombre que no figure en la lista, para el caso de que la enumeración del servidor no devuelva todos lo servidores disponibles. Además, este método puede tardar mucho en ejecutarse, por lo que le recomendamos que sea muy precavido a la hora de llamarlo siempre que el rendimiento sea muy importante.

Ejemplo

En la aplicación de consola siguiente se recupera información sobre todas las instancias visibles de SQL Server y se muestra la información en la ventana de la consola.

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

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión

.NET Framework

Compatible con: 2.0
Vea también

Etiquetas :


Page view tracker