SqlClientFactory.CanCreateDataSourceEnumerator 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得值，這個值表示是否可建立 SqlDataSourceEnumerator。

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

public override bool CanCreateDataSourceEnumerator { get; }

member this.CanCreateDataSourceEnumerator : bool

Public Overrides ReadOnly Property CanCreateDataSourceEnumerator As Boolean

屬性值

Boolean

true SqlDataSourceEnumerator如果可以建立 ，則為 ，否則為 false。

範例

下列範例會使用可列舉任何提供者數據源的程式代碼，顯示所有可用 SQL Server 數據源的清單。

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

備註

類別 DbProviderFactory 提供 CanCreateDataSourceEnumerator 屬性，讓繼承者可以指出是否可以提供數據源列舉值。 會顯示 SqlClientFactory 這個屬性，但其值一律 true為 。

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)