DbConnectionStringBuilder.AppendKeyValuePair Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.

Surcharges

AppendKeyValuePair(StringBuilder, String, String)	Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.

AppendKeyValuePair(StringBuilder, String, String)

Source:

DbConnectionStringBuilder.cs

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.

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.

keyword

String

Clé à ajouter.

value

String

Valeur de la clé fournie.

Exemples

Si un processus a créé un chaîne de connexion, mais qu’une application doit maintenant effectuer une simple modification de cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/valeur à l’aide d’un StringBuilder objet. Au lieu de créer un nouveau DbConnectionStringBuilder, les développeurs peuvent appeler la AppendKeyValuePair méthode, en transmettant 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 qui utilisent un StringBuilder pour créer une collection de paires clé/valeur de pouvoir tirer parti des fonctionnalités incluses dans la DbConnectionStringBuilder classe lorsque vous ajoutez des paires clé/valeur, sans avoir à supporter la surcharge liée à la création et à la maintenance d’un DbConnectionStringBuilder instance. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne au fourni StringBuilder.

Voir aussi

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

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Source:

DbConnectionStringBuilder.cs

Offre un moyen efficace et sûr d’ajouter une clé et une valeur à un objet StringBuilder existant.

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.

keyword

String

Clé à ajouter.

value

String

Valeur de la clé fournie.

useOdbcRules

Boolean

true pour utiliser {} pour délimiter les champs ; false pour utiliser des guillemets.

Exemples

Si un processus a créé un chaîne de connexion, mais qu’une application doit maintenant effectuer une simple modification de cette chaîne de connexion, il peut être plus efficace d’ajouter simplement la paire clé/valeur à l’aide d’un StringBuilder objet. Au lieu de créer un nouveau DbConnectionStringBuilder, les développeurs peuvent appeler la AppendKeyValuePair méthode, en transmettant un StringBuilder qui contient le chaîne de connexion fourni. La procédure suivante montre un exemple simple de cette technique, en utilisant des règles ODBC pour citer des 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 qui utilisent un StringBuilder pour créer une collection de paires clé/valeur afin de pouvoir tirer parti des fonctionnalités incluses dans la classe lors de l’ajout DbConnectionStringBuilder de paires clé/valeur, sans avoir à supporter la surcharge liée à la création et à la maintenance d’un DbConnectionStringBuilder instance. La AppendKeyValuePair méthode met en forme la clé et la valeur correctement et ajoute la nouvelle chaîne au fourni StringBuilder.

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

Voir aussi

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