DbConnectionStringBuilder.AppendKeyValuePair Methode

Definition

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

Ü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.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

AppendKeyValuePair(StringBuilder, String, String)

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

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.The StringBuilder to which to add the key/value pair.

keyword
String

Der hinzuzufügende Schlüssel.The key to be added.

value
String

Der Wert für den bereitgestellten Schlüssel.The value for the supplied key.

Beispiele

Wenn ein Prozess eine Verbindungs Zeichenfolge erstellt hat, eine Anwendung jedoch eine einfache Änderung an dieser Verbindungs Zeichenfolge ausführen muss, kann es effizienter sein, das Schlüssel-Wert-Paar einfach mithilfe eines StringBuilder Objekts hinzuzufügen.If some process has created a connection string, but now an application must perform a simple modification to that connection string, it may be more efficient to just add the key/value pair using a StringBuilder object. Anstatt eine neue DbConnectionStringBuilderzu erstellen, können Entwickler die AppendKeyValuePair-Methode anrufen und eine StringBuilder übergeben, die die angegebene Verbindungs Zeichenfolge enthält.Instead of creating a new DbConnectionStringBuilder, developers can call the AppendKeyValuePair method, passing in a StringBuilder that contains the supplied connection string. Das folgende Verfahren zeigt ein einfaches Beispiel für diese Technik.The following procedure shows a simple example of this technique.

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, die eine StringBuilder verwenden, eine Auflistung 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 dass Sie den Aufwand für das Erstellen und Verwalten einer DbConnectionStringBuilder Instanz verursachen müssen.This method allows developers using a StringBuilder to create a collection of key/value pairs to be able to take advantage of the features included in the DbConnectionStringBuilder class when you add key/value pairs, without having to incur the overhead of creating and maintaining a DbConnectionStringBuilder instance. Die AppendKeyValuePair-Methode formatiert den Schlüssel und den Wert ordnungsgemäß und fügt die neue Zeichenfolge dem angegebenen StringBuilderhinzu.The AppendKeyValuePair method formats the key and value correctly and adds the new string to the supplied StringBuilder.

Siehe auch

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Bietet eine effiziente und sichere Möglichkeit, einen Schlüssel und Wert an ein vorhandenes StringBuilder-Objekt anzufügen.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

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.The StringBuilder to which to add the key/value pair.

keyword
String

Der hinzuzufügende Schlüssel.The key to be added.

value
String

Der Wert für den bereitgestellten Schlüssel.The value for the supplied key.

useOdbcRules
Boolean

true zum Begrenzen von Feldern mit {}, false zum Verwenden von Anführungszeichen.true to use {} to delimit fields, false to use quotation marks.

Beispiele

Wenn ein Prozess eine Verbindungs Zeichenfolge erstellt hat, eine Anwendung jedoch eine einfache Änderung an dieser Verbindungs Zeichenfolge ausführen muss, kann es effizienter sein, das Schlüssel-Wert-Paar einfach mithilfe eines StringBuilder Objekts hinzuzufügen.If some process has created a connection string, but now an application must perform a simple modification to that connection string, it might be more efficient to just add the key/value pair using a StringBuilder object. Anstatt eine neue DbConnectionStringBuilderzu erstellen, können Entwickler die AppendKeyValuePair-Methode anrufen und eine StringBuilder übergeben, die die angegebene Verbindungs Zeichenfolge enthält.Instead of creating a new DbConnectionStringBuilder, developers can call the AppendKeyValuePair method, passing in a StringBuilder that contains the supplied connection string. Das folgende Verfahren zeigt ein einfaches Beispiel für diese Technik unter Verwendung von ODBC-Regeln zum Zitieren von Werten.The following procedure shows a simple example of this technique, using ODBC rules for quoting values.

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, die eine StringBuilder verwenden, eine Auflistung 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 dass Sie den Aufwand für das Erstellen und Verwalten einer DbConnectionStringBuilder Instanz verursachen müssen.This method allows developers using a StringBuilder to create a collection of key/value pairs to be able to take advantage of the features included in the DbConnectionStringBuilder class when adding key/value pairs, without having to incur the overhead of creating and maintaining a DbConnectionStringBuilder instance. Die AppendKeyValuePair-Methode formatiert den Schlüssel und den Wert ordnungsgemäß und fügt die neue Zeichenfolge dem angegebenen StringBuilderhinzu.The AppendKeyValuePair method formats the key and value correctly and adds the new string to the supplied StringBuilder.

Obwohl mit den meisten Datenquellen Felder mithilfe von Anführungszeichen begrenzt werden können, müssen Sie für ODBC-Verbindungs Zeichenfolgen keine geschweiften Klammern ({}) verwenden.Although most data sources let you delimit fields by using quotation marks, ODBC does not--for ODBC connection strings, you must use curly braces ({}). Legen Sie den Parameter useOdbcRules auf truefest, damit das DbConnectionStringBuilder ODBC-Regeln zum Begrenzen von Feldern verwendet.In order to have the DbConnectionStringBuilder use ODBC rules for delimiting fields, set the useOdbcRules parameter to true.

Siehe auch

Gilt für: