DbConnectionStringBuilder.AppendKeyValuePair Méthode

Définition

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

Surcharges

AppendKeyValuePair(StringBuilder, String, String)

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.Provides an efficient and safe way to append a key and value to an existing StringBuilder object.

AppendKeyValuePair(StringBuilder, String, String)

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.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)

Paramètres

builder
StringBuilder

StringBuilder auquel ajouter la paire clé/valeur.The StringBuilder to which to add the key/value pair.

keyword
String

Clé à ajouter.The key to be added.

value
String

Valeur de la clé fournie.The value for the supplied key.

Exemples

Si un processus a créé une chaîne de connexion, mais qu’une application doit maintenant apporter une modification simple à cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/ StringBuilder valeur à l’aide d’un objet.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. Au lieu de créer un DbConnectionStringBuildernouveau, les développeurs peuvent AppendKeyValuePair appeler la méthode, en StringBuilder passant un qui contient la chaîne de connexion fournie.Instead of creating a new DbConnectionStringBuilder, developers can call the AppendKeyValuePair method, passing in a StringBuilder that contains the supplied connection string. La procédure suivante montre un exemple simple de cette technique.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

Remarques

Cette méthode permet aux développeurs qui StringBuilder utilisent un de créer une collection de paires clé/valeur pour pouvoir tirer parti des fonctionnalités incluses dans la DbConnectionStringBuilder classe lorsque vous ajoutez des paires clé/valeur, sans avoir à subir la surcharge liée à la création et maintenance d' DbConnectionStringBuilder une instance de.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. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne StringBuilderau fourni.The AppendKeyValuePair method formats the key and value correctly and adds the new string to the supplied StringBuilder.

Voir aussi

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.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)

Paramètres

builder
StringBuilder

StringBuilder auquel ajouter la paire clé/valeur.The StringBuilder to which to add the key/value pair.

keyword
String

Clé à ajouter.The key to be added.

value
String

Valeur de la clé fournie.The value for the supplied key.

useOdbcRules
Boolean

true pour utiliser {} pour délimiter les champs ; false pour utiliser des guillemets.true to use {} to delimit fields, false to use quotation marks.

Exemples

Si un processus a créé une chaîne de connexion, mais qu’une application doit maintenant apporter une modification simple à cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/ StringBuilder valeur à l’aide d’un objet.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. Au lieu de créer un DbConnectionStringBuildernouveau, les développeurs peuvent AppendKeyValuePair appeler la méthode, en StringBuilder passant un qui contient la chaîne de connexion fournie.Instead of creating a new DbConnectionStringBuilder, developers can call the AppendKeyValuePair method, passing in a StringBuilder that contains the supplied connection string. La procédure suivante montre un exemple simple de cette technique, à l’aide de règles ODBC pour citer les valeurs.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

Remarques

Cette méthode permet aux développeurs qui StringBuilder utilisent un de créer une collection de paires clé/valeur pour pouvoir tirer parti des fonctionnalités incluses dans la DbConnectionStringBuilder classe lors de l’ajout de paires clé/valeur, sans avoir à subir la surcharge liée à la création et maintenance d' DbConnectionStringBuilder une instance de.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. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne StringBuilderau fourni.The AppendKeyValuePair method formats the key and value correctly and adds the new string to the supplied StringBuilder.

Bien que la plupart des sources de données vous permettent de délimiter les champs en utilisant des guillemets, ODBC ne le fait pas--pour les{}chaînes de connexion ODBC, vous devez utiliser des accolades ().Although most data sources let you delimit fields by using quotation marks, ODBC does not--for ODBC connection strings, you must use curly braces ({}). Pour que utilise les DbConnectionStringBuilder règles ODBC pour délimiter les champs, affectez au paramètre truela useOdbcRules valeur.In order to have the DbConnectionStringBuilder use ODBC rules for delimiting fields, set the useOdbcRules parameter to true.

Voir aussi

S’applique à