SqlConnectionStringBuilder Oluşturucular

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

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

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 ()

Ayrıca bkz.

• ADO.NET’e Genel Bakış

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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 bir Boole değeri veya sayısal değer beklendiğinde ancak 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 çiftleri arasında yineleme yapar. 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 System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

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.

Ayrıca bkz.

• Bağlantı Dizeleri (ADO.NET)
• ADO.NET’e Genel Bakış