SqlConnectionStringBuilder Oluşturucular

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

SqlConnectionStringBuilder()	SqlConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
SqlConnectionStringBuilder(String)	SqlConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgileri için verileri sağlar.

SqlConnectionStringBuilder()

SqlConnectionStringBuilder sınıfının yeni bir örneğini başlatır.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder();

Public Sub New ()

SqlConnectionStringBuilder(String)

SqlConnectionStringBuilder sınıfının yeni bir örneğini başlatır. Sağlanan bağlantı dizesi, örneğin iç bağlantı bilgileri için verileri sağlar.

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);

public SqlConnectionStringBuilder(string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Parametreler

connectionString

String

Nesnenin iç bağlantı bilgilerinin temeli. Ad/değer çiftlerine ayrıştırılır. Geçersiz anahtar adları oluşturur KeyNotFoundException.

Özel durumlar

KeyNotFoundException

Bağlantı dizesi içinde geçersiz anahtar adı.

FormatException

Bağlantı dizesi içinde geçersiz değer (özellikle boole değeri veya sayısal değer beklendiği halde sağlanmadığında).

ArgumentException

Sağlanan connectionString geçerli değil.

Örnekler

Aşağıdaki örnek, nesnenin SqlConnectionStringBuilder oluşturucusunda basit bir SQL Server bağlantı dizesi sağlar ve ardından nesne içindeki tüm anahtar/değer çiftlerinde yinelenir. Koleksiyonun her öğe için varsayılan değerler sağladığını unutmayın. Ayrıca, sınıfın SqlConnectionStringBuilder iyi bilinen anahtarlar için eş anlamlıları iyi bilinen adlarla tutarlı olacak şekilde dönüştürdüğünü unutmayın.

Not

Bu örnek, bağlantı dizeleriyle nasıl SqlConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

Açıklamalar

SqlConnectionStringBuilder sınıfı, anahtar/değer çiftlerinden oluşan sabit bir iç koleksiyon sağlar. Oluşturucudaki olası bağlantı dizesi değerlerinin yalnızca küçük bir alt kümesini sağlasanız bile, nesne her zaman her anahtar/değer çifti için varsayılan değerler sağlar. nesnesinin ConnectionString özelliği alındığında, dize yalnızca değerin öğe için varsayılan değer olmadığı anahtar/değer çiftlerini içerir.