SqlClientFactory.CanCreateDataSourceEnumerator Propriété

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Obtient une valeur qui indique si un SqlDataSourceEnumerator peut être créé.

public:
 virtual property bool CanCreateDataSourceEnumerator { bool get(); };

public override bool CanCreateDataSourceEnumerator { get; }

member this.CanCreateDataSourceEnumerator : bool

Public Overrides ReadOnly Property CanCreateDataSourceEnumerator As Boolean

Valeur de propriété

Boolean

true si un SqlDataSourceEnumerator peut être créé ; sinon, false.

Exemples

L’exemple suivant affiche la liste de toutes les sources de données SQL Server disponibles, à l’aide d’un code qui peut énumérer les sources de données pour n’importe quel fournisseur.

using System;
using System.Data;
using System.Data.Common;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        // List all SQL Server instances:
        ListServers(SqlClientFactory.Instance);

        Console.WriteLine();
        Console.WriteLine("Press any key to continue...");
        Console.ReadKey();
    }
    private static void ListServers(DbProviderFactory factory)
    {
        // This procedure is provider-agnostic, and can list
        // instances of any provider's servers. Of course,
        // not all providers can create a data source enumerator,
        // so it's best to check the CanCreateDataSourceEnumerator
        // property before attempting to list the data sources.
        if (factory.CanCreateDataSourceEnumerator)
        {
            DbDataSourceEnumerator instance =
                factory.CreateDataSourceEnumerator();
            DataTable table = instance.GetDataSources();

            foreach (DataRow row in table.Rows)
            {
                Console.WriteLine("{0}\\{1}",
                    row["ServerName"], row["InstanceName"]);
            }
        }
    }
}

Imports System.Data
Imports System.Data.Common
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        ' List all SQL Server instances:
        ListServers(SqlClientFactory.Instance)

        Console.WriteLine()
        Console.WriteLine("Press any key to continue.")
        Console.ReadKey()
    End Sub

    Private Sub ListServers(ByVal factory As DbProviderFactory)
        ' This procedure is provider-agnostic, and can list
        ' instances of any provider's servers. Of course, 
        ' not all providers can create a data source enumerator,
        ' so it's best to check the CanCreateDataSourceEnumerator property
        ' before attempting to list the data sources.
        If factory.CanCreateDataSourceEnumerator Then
            Dim instance As DbDataSourceEnumerator = _
             factory.CreateDataSourceEnumerator
            Dim table As System.Data.DataTable = instance.GetDataSources()

            Dim row As DataRow
            For Each row In table.Rows
                Console.WriteLine("{0}\{1}", _
                 row("ServerName"), row("InstanceName"))
            Next
        End If
    End Sub
End Module

Remarques

La DbProviderFactory classe fournit la CanCreateDataSourceEnumerator propriété afin que les héritiers puissent indiquer s’ils peuvent fournir un énumérateur de source de données. affiche SqlClientFactory cette propriété, mais sa valeur est toujours true.

Voir aussi

• Vue d'ensemble d’ADO.NET