DbConnectionStringBuilder.AppendKeyValuePair Methode

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.

Überlädt

AppendKeyValuePair(StringBuilder, String, String)	Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.

AppendKeyValuePair(StringBuilder, String, String)

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.

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

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)

Parameter

builder: StringBuilder

Der StringBuilder, dem das Schlüssel-Wert-Paar hinzugefügt werden soll.

keyword: String

Der hinzuzufügende Schlüssel.

value: String

Der Wert für den bereitgestellten Schlüssel.

Beispiele

Wenn ein Prozess eine Verbindungszeichenfolge erstellt hat, aber jetzt muss eine Anwendung eine einfache Änderung an dieser Verbindungszeichenfolge ausführen, kann es effizienter sein, einfach das Schlüssel-Wert-Paar mithilfe eines StringBuilder Objekts hinzuzufügen. Anstatt eine neue DbConnectionStringBuilderzu erstellen, können Entwickler die AppendKeyValuePair Methode aufrufen, indem Sie eine StringBuilder übergeben, die die angegebene Verbindungszeichenfolge enthält. Das folgende Verfahren zeigt ein einfaches Beispiel für diese Technik.

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

Hinweise

Mit dieser Methode können Entwickler eine StringBuilder Sammlung von Schlüssel-Wert-Paaren erstellen, um die In der DbConnectionStringBuilder Klasse enthaltenen Features nutzen zu können, wenn Sie Schlüssel-Wert-Paare hinzufügen, ohne den Aufwand für das Erstellen und Verwalten einer DbConnectionStringBuilder Instanz zu übernehmen. Die AppendKeyValuePair Methode formatiert den Schlüssel und den Wert richtig und fügt die neue Zeichenfolge zur angegebenen StringBuilderZeichenfolge hinzu.

Siehe auch

Gilt für:

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.

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

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)

Parameter

builder: StringBuilder

Der StringBuilder, dem das Schlüssel-Wert-Paar hinzugefügt werden soll.

keyword: String

Der hinzuzufügende Schlüssel.

value: String

Der Wert für den bereitgestellten Schlüssel.

useOdbcRules: Boolean

true zum Begrenzen von Feldern mit {}, false zum Verwenden von Anführungszeichen.

Beispiele

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

Hinweise

Mit dieser Methode können Entwickler eine StringBuilder Sammlung von Schlüssel-Wert-Paaren erstellen, um die In der DbConnectionStringBuilder Klasse enthaltenen Features beim Hinzufügen von Schlüssel-Wert-Paaren nutzen zu können, ohne den Aufwand für das Erstellen und Verwalten einer DbConnectionStringBuilder Instanz zu übernehmen. Die AppendKeyValuePair Methode formatiert den Schlüssel und den Wert richtig und fügt die neue Zeichenfolge zur angegebenen StringBuilderZeichenfolge hinzu.

Obwohl in den meisten Datenquellen Felder mithilfe von Anführungszeichen getrennt werden können, ist ODBC nicht für ODBC-Verbindungszeichenfolgen geeignet, Sie müssen geschweifte Geschweifte ({}) verwenden. Um die DbConnectionStringBuilder ODBC-Regeln zum Trennen von Feldern verwenden zu können, legen Sie den useOdbcRules Parameter auf true.

Siehe auch

Gilt für: