DbConnectionStringBuilder.AppendKeyValuePair Methode

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

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)

Quelle:

DbConnectionStringBuilder.cs

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

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 eine Anwendung eine einfache Änderung an diesem Verbindungszeichenfolge vornehmen muss, ist es möglicherweise effizienter, das Schlüssel-Wert-Paar einfach mithilfe eines StringBuilder -Objekts hinzuzufügen. Anstatt eine neue DbConnectionStringBuilderzu erstellen, können Entwickler die AppendKeyValuePair -Methode aufrufen und 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 StringBuilder eine Sammlung von Schlüssel-Wert-Paaren erstellen, um die in der DbConnectionStringBuilder -Klasse enthaltenen Features zu nutzen, wenn Sie Schlüssel-Wert-Paare hinzufügen, ohne dass der Aufwand für das Erstellen und Verwalten eines DbConnectionStringBuilder instance entstehen muss. Die AppendKeyValuePair -Methode formatiert den Schlüssel und den Wert ordnungsgemäß und fügt die neue Zeichenfolge der angegebenen StringBuilderhinzu.

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Quelle:

DbConnectionStringBuilder.cs

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

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

Wenn ein Prozess eine Verbindungszeichenfolge erstellt hat, eine Anwendung jetzt jedoch eine einfache Änderung an diesem Verbindungszeichenfolge vornehmen muss, ist es möglicherweise effizienter, das Schlüssel-Wert-Paar einfach mithilfe eines StringBuilder -Objekts hinzuzufügen. Anstatt eine neue DbConnectionStringBuilderzu erstellen, können Entwickler die AppendKeyValuePair -Methode aufrufen und eine StringBuilder übergeben, die die angegebene Verbindungszeichenfolge enthält. Das folgende Verfahren zeigt ein einfaches Beispiel für dieses Verfahren, bei dem ODBC-Regeln zum Anführungszeichen von Werten verwendet werden.

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 StringBuilder eine 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 dass der Aufwand für das Erstellen und Verwalten eines DbConnectionStringBuilder instance entstehen muss. Die AppendKeyValuePair -Methode formatiert den Schlüssel und den Wert ordnungsgemäß und fügt die neue Zeichenfolge der angegebenen StringBuilderhinzu.

Die meisten Datenquellen ermöglichen es Ihnen zwar, Felder mithilfe von Anführungszeichen abzugrenzen, ODBC jedoch nicht. Für ODBC-Verbindungszeichenfolgen müssen Sie geschweifte Klammern ({}) verwenden. Legen Sie useOdbcRules den DbConnectionStringBuilder Parameter auf truefest, damit ODBC-Regeln zum Trennen von Feldern verwendet werden.

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET