DbConnectionStringBuilder.AppendKeyValuePair Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Mevcut StringBuilder bir nesneye anahtar ve değer eklemenin verimli ve güvenli bir yolunu sağlar.

Aşırı Yüklemeler

AppendKeyValuePair(StringBuilder, String, String)	Mevcut StringBuilder bir nesneye anahtar ve değer eklemenin verimli ve güvenli bir yolunu sağlar.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Mevcut StringBuilder bir nesneye anahtar ve değer eklemenin verimli ve güvenli bir yolunu sağlar.

AppendKeyValuePair(StringBuilder, String, String)

Kaynak:

DbConnectionStringBuilder.cs

Mevcut StringBuilder bir nesneye anahtar ve değer eklemenin verimli ve güvenli bir yolunu sağlar.

public:
 static void AppendKeyValuePair(System::Text::StringBuilder ^ builder, System::String ^ keyword, System::String ^ value);

public static void AppendKeyValuePair (System.Text.StringBuilder builder, string keyword, string? value);

static member AppendKeyValuePair : System.Text.StringBuilder * string * string -> unit

Public Shared Sub AppendKeyValuePair (builder As StringBuilder, keyword As String, value As String)

Parametreler

builder

StringBuilder

StringBuilder Anahtar/değer çiftinin ekleneceği yer.

keyword

String

Eklenecek anahtar.

value

String

Sağlanan anahtarın değeri.

Örnekler

Bir işlem bir bağlantı dizesi oluşturduysa ancak şimdi bir uygulamanın bu bağlantı dizesi basit bir değişiklik yapması gerekiyorsa, yalnızca bir StringBuilder nesne kullanarak anahtar/değer çiftini eklemek daha verimli olabilir. Geliştiriciler yeni DbConnectionStringBuilderbir oluşturmak yerine, sağlanan bağlantı dizesi içeren bir StringBuilder geçirerek yöntemini çağırabilirAppendKeyValuePair. Aşağıdaki yordamda bu tekniğin basit bir örneği gösterilmektedir.

public string AddPooling(string connectionString)
{
    StringBuilder builder = new StringBuilder(connectionString);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "true");
    return builder.ToString();
}

Public Function AddPooling(ByVal connectionString As String) As String
    Dim builder As New StringBuilder(connectionString)
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "True")
    Return builder.ToString()
End Function

Açıklamalar

Bu yöntem, StringBuilder anahtar/değer çiftlerinden oluşan bir koleksiyon oluşturmak için kullanan geliştiricilerin anahtar/değer çiftleri eklediğinizde sınıfa dahil edilen DbConnectionStringBuilder özelliklerden yararlanabilmesini sağlar ve örneği oluşturma ve bakımını yapma DbConnectionStringBuilder yüküne neden olmaz. AppendKeyValuePair yöntemi, anahtarı ve değeri doğru biçimlendirip yeni dizeyi sağlanan StringBuilderöğesine ekler.

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Kaynak:

DbConnectionStringBuilder.cs

Mevcut StringBuilder bir nesneye anahtar ve değer eklemenin verimli ve güvenli bir yolunu sağlar.

public:
 static void AppendKeyValuePair(System::Text::StringBuilder ^ builder, System::String ^ keyword, System::String ^ value, bool useOdbcRules);

public static void AppendKeyValuePair (System.Text.StringBuilder builder, string keyword, string? value, bool useOdbcRules);

static member AppendKeyValuePair : System.Text.StringBuilder * string * string * bool -> unit

Public Shared Sub AppendKeyValuePair (builder As StringBuilder, keyword As String, value As String, useOdbcRules As Boolean)

Parametreler

builder

StringBuilder

StringBuilder Anahtar/değer çiftinin ekleneceği yer.

keyword

String

Eklenecek anahtar.

value

String

Sağlanan anahtarın değeri.

useOdbcRules

Boolean

truealanları sınırlandırmak için, false tırnak işaretlerini kullanmak için kullanın{}.

Örnekler

Bir işlem bir bağlantı dizesi oluşturduysa ancak şimdi uygulamanın bu bağlantı dizesi basit bir değişiklik yapması gerekiyorsa, anahtar/değer çiftini nesne StringBuilder kullanarak eklemek daha verimli olabilir. Geliştiriciler yeni DbConnectionStringBuilderbir oluşturmak yerine, sağlanan bağlantı dizesi içeren bir StringBuilder geçirerek yöntemini çağırabilirAppendKeyValuePair. Aşağıdaki yordamda, değerlerin alıntılanması için ODBC kurallarının kullanıldığı bu tekniğin basit bir örneği gösterilmektedir.

public string AddPooling(string connectionString)
{
    StringBuilder builder = new StringBuilder(connectionString);
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "true");
    return builder.ToString();
}

Public Function AddPooling(ByVal connectionString As String) As String
    Dim builder As New StringBuilder(connectionString)
    DbConnectionStringBuilder.AppendKeyValuePair(builder, "Pooling", "True")
    Return builder.ToString()
End Function

Açıklamalar

Bu yöntem, bir anahtar/değer çifti koleksiyonu oluşturmak için kullanan StringBuilder geliştiricilerin anahtar/değer çiftleri eklerken sınıfa dahil edilen DbConnectionStringBuilder özelliklerden yararlanabilmesini sağlar ve örneği DbConnectionStringBuilder oluşturma ve bakımını yapma yüküne neden olmaz. AppendKeyValuePair yöntemi, anahtarı ve değeri doğru biçimlendirip yeni dizeyi sağlanan StringBuilderöğesine ekler.

Veri kaynaklarının çoğu alanları tırnak işaretlerini kullanarak sınırlandırmanıza izin verse de ODBC, ODBC bağlantı dizeleri için küme ayraçları ({} kullanmanız gerekir). Alanları sınırlandırmak DbConnectionStringBuilder için ODBC kurallarını kullanmak için parametresini useOdbcRules olarak trueayarlayın.

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış