DbConnectionStringBuilder.AppendKeyValuePair Yöntem

Tanım

Ad Alanı:
System.Data.Common
Bütünleştirilmiş Kod:
System.Data.Common.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kod:
netstandard.dll

Mevcut bir StringBuilder nesnesine anahtar ve değer eklemek için verimli ve güvenli bir yol sağlar.

Aşırı Yüklemeler

Name Description
AppendKeyValuePair(StringBuilder, String, String)

Mevcut bir StringBuilder nesnesine anahtar ve değer eklemek için verimli ve güvenli bir yol sağlar.
AppendKeyValuePair(StringBuilder, String, String, Boolean)

Mevcut bir StringBuilder nesnesine anahtar ve değer eklemek için verimli ve güvenli bir yol sağlar.

AppendKeyValuePair(StringBuilder, String, String)

Mevcut bir StringBuilder nesnesine anahtar ve değer eklemek için verimli ve güvenli bir yol 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 uygulamanın bu bağlantı dizesi basit bir değişiklik yapması gerekiyorsa, StringBuilder nesnesi kullanarak anahtar/değer çiftini eklemek daha verimli olabilir. Geliştiriciler yeni bir DbConnectionStringBuilder oluşturmak yerine, sağlanan bağlantı dizesi içeren bir StringBuilder geçirerek AppendKeyValuePair yöntemini çağırabilir. 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, anahtar/değer çiftlerinden oluşan bir koleksiyon oluşturmak için kullanan StringBuilder geliştiricilerin anahtar/değer çiftleri eklediğinizde sınıfına dahil edilen DbConnectionStringBuilder özelliklerden yararlanabilmesine olanak tanır 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.

Ayrıca bkz.

Şunlara uygulanır

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Mevcut bir StringBuilder nesnesine anahtar ve değer eklemek için verimli ve güvenli bir yol 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, StringBuilder nesnesi kullanarak anahtar/değer çiftini eklemek daha verimli olabilir. Geliştiriciler yeni bir DbConnectionStringBuilder oluşturmak yerine, sağlanan bağlantı dizesi içeren bir StringBuilder geçirerek AppendKeyValuePair yöntemini çağırabilir. 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, anahtar/değer çiftlerinden oluşan bir koleksiyon oluşturmak için kullanan StringBuilder geliştiricilerin anahtar/değer çiftleri eklerken sınıfına dahil edilen DbConnectionStringBuilder özelliklerden yararlanabilmesine olanak tanır 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 bunu yapmaz; 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.

Şunlara uygulanır