DbConnectionStringBuilder.AppendKeyValuePair Méthode

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

Exemples

Si un processus a créé un chaîne de connexion, mais qu’une application doit maintenant effectuer une modification simple de cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/valeur à l’aide d’un objet StringBuilder. Au lieu de créer une nouvelle DbConnectionStringBuilder, les développeurs peuvent appeler la méthode AppendKeyValuePair, en passant un StringBuilder qui contient le chaîne de connexion fourni. La procédure suivante montre un exemple simple de cette 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 d’utiliser une StringBuilder 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 de création et de maintenance d’une DbConnectionStringBuilder instance. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne à l’élément fourni StringBuilder.

Voir aussi

• Chaînes de connexion dans ADO.NET
• Vue d'ensemble d’ADO.NET

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

Exemples

Si un processus a créé un chaîne de connexion, mais qu’une application doit maintenant effectuer une modification simple de cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/valeur à l’aide d’un objet StringBuilder. Au lieu de créer une nouvelle DbConnectionStringBuilder, les développeurs peuvent appeler la méthode AppendKeyValuePair, en passant un StringBuilder qui contient le chaîne de connexion fourni. La procédure suivante montre un exemple simple de cette technique, à l’aide de règles ODBC pour les guillemets de valeurs.

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 d’utiliser une StringBuilder collection de paires clé/valeur pour pouvoir tirer parti des fonctionnalités incluses dans la classe lors de l’ajout DbConnectionStringBuilder de paires clé/valeur, sans avoir à subir la surcharge liée à la création et à la maintenance d’une DbConnectionStringBuilder instance. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne à l’élément fourni StringBuilder.

Bien que la plupart des sources de données vous permettent de délimiter des champs à l’aide de guillemets, ODBC ne permet pas aux chaînes de connexion ODBC d’utiliser des accolades ({}). Pour avoir les DbConnectionStringBuilder règles ODBC d’utilisation pour limiter les champs, définissez le useOdbcRules paramètre truesur .

Voir aussi

• Chaînes de connexion dans ADO.NET
• Vue d'ensemble d’ADO.NET