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)
Visual Basic (Declaración)
Public Overrides Function GetDataSources As DataTable
Dim instance As SqlDataSourceEnumerator
Dim returnValue As DataTable
returnValue = instance.GetDataSources
public override DataTable GetDataSources ()
public:
virtual DataTable^ GetDataSources () override
public DataTable GetDataSources ()
public override function GetDataSources () : DataTable
Valor devuelto
Devuelve un objeto DataTable que contiene información sobre las instancias visibles de SQL Server.
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). |
Nota |
|---|
| 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. |
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.
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("============================");
}
}
}
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.
.NET Framework
Compatible con: 2.0