DbConnectionStringBuilder.AppendKeyValuePair Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Fornisce una modalità sicura ed efficiente per aggiungere una chiave e un valore a un oggetto StringBuilder esistente.

Overload

AppendKeyValuePair(StringBuilder, String, String)	Fornisce una modalità sicura ed efficiente per aggiungere una chiave e un valore a un oggetto StringBuilder esistente.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Fornisce una modalità sicura ed efficiente per aggiungere una chiave e un valore a un oggetto StringBuilder esistente.

AppendKeyValuePair(StringBuilder, String, String)

Source:

DbConnectionStringBuilder.cs

Fornisce una modalità sicura ed efficiente per aggiungere una chiave e un valore a un oggetto StringBuilder esistente.

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)

Parametri

builder

StringBuilder

Oggetto StringBuilder a cui aggiungere la coppia chiave/valore.

keyword

String

Chiave da aggiungere.

value

String

Valore per la chiave fornita.

Esempio

Se un processo ha creato una stringa di connessione, ma ora un'applicazione deve eseguire una semplice modifica a tale stringa di connessione, potrebbe essere più efficiente aggiungere solo la coppia chiave/valore usando un StringBuilder oggetto. Anziché creare un nuovo DbConnectionStringBuilder, gli sviluppatori possono chiamare il AppendKeyValuePair metodo, passando un StringBuilder oggetto contenente la stringa di connessione fornita. La procedura seguente illustra un semplice esempio di questa tecnica.

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

Commenti

Questo metodo consente agli sviluppatori di usare un oggetto StringBuilder per creare una raccolta di coppie chiave/valore per poter sfruttare le funzionalità incluse nella classe quando si aggiungono coppie chiave/valore, senza dover incorrere nel sovraccarico della creazione e della gestione di un'istanza DbConnectionStringBuilderDbConnectionStringBuilder . Il AppendKeyValuePair metodo formatta correttamente la chiave e il valore e aggiunge la nuova stringa all'oggetto StringBuilderspecificato.

Vedi anche

• Stringhe di connessione in ADO.NET
• Panoramica di ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Source:

DbConnectionStringBuilder.cs

Fornisce una modalità sicura ed efficiente per aggiungere una chiave e un valore a un oggetto StringBuilder esistente.

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)

Parametri

builder

StringBuilder

Oggetto StringBuilder a cui aggiungere la coppia chiave/valore.

keyword

String

Chiave da aggiungere.

value

String

Valore per la chiave fornita.

useOdbcRules

Boolean

true per usare {} come delimitatori dei campi, false per usare le virgolette.

Esempio

Se un processo ha creato una stringa di connessione, ma ora un'applicazione deve eseguire una semplice modifica a tale stringa di connessione, potrebbe essere più efficiente aggiungere semplicemente la coppia chiave/valore usando un StringBuilder oggetto. Anziché creare un nuovo DbConnectionStringBuilder, gli sviluppatori possono chiamare il AppendKeyValuePair metodo, passando un StringBuilder oggetto contenente la stringa di connessione fornita. La procedura seguente illustra un semplice esempio di questa tecnica, usando le regole ODBC per i valori di virgolette.

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

Commenti

Questo metodo consente agli sviluppatori di usare un oggetto StringBuilder per creare una raccolta di coppie chiave/valore per poter sfruttare le funzionalità incluse nella classe quando si aggiungono coppie chiave/valore, senza dover incorrere nel sovraccarico della creazione e della gestione di un'istanza DbConnectionStringBuilderDbConnectionStringBuilder . Il AppendKeyValuePair metodo formatta correttamente la chiave e il valore e aggiunge la nuova stringa all'oggetto StringBuilderspecificato.

Anche se la maggior parte delle origini dati consente di delimitare i campi usando virgolette, ODBC non per le stringhe di connessione ODBC, è necessario usare parentesi graffe ({}). Per avere le DbConnectionStringBuilder regole ODBC per delimitare i campi, impostare il useOdbcRules parametro su true.

Vedi anche

• Stringhe di connessione in ADO.NET
• Panoramica di ADO.NET