DbConnectionStringBuilder.AppendKeyValuePair Método

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Proporciona una manera eficaz y segura de anexar una clave y un valor a un objeto StringBuilder existente.

Sobrecargas

AppendKeyValuePair(StringBuilder, String, String)	Proporciona una manera eficaz y segura de anexar una clave y un valor a un objeto StringBuilder existente.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Proporciona una manera eficaz y segura de anexar una clave y un valor a un objeto StringBuilder existente.

AppendKeyValuePair(StringBuilder, String, String)

Source:

DbConnectionStringBuilder.cs

Proporciona una manera eficaz y segura de anexar una clave y un valor a un objeto StringBuilder existente.

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)

Parámetros

builder

StringBuilder

StringBuilder al que se agrega el par clave/valor.

keyword

String

Clave que se va a agregar.

value

String

Valor de la clave proporcionada.

Ejemplos

Si algún proceso ha creado un cadena de conexión, pero ahora una aplicación debe realizar una modificación sencilla de ese cadena de conexión, puede ser más eficaz simplemente agregar el par clave-valor mediante un StringBuilder objeto . En lugar de crear un nuevo DbConnectionStringBuilder, los desarrolladores pueden llamar al AppendKeyValuePair método , pasando un StringBuilder objeto que contiene el cadena de conexión proporcionado. En el procedimiento siguiente se muestra un ejemplo sencillo de esta técnica.

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

Comentarios

Este método permite a los desarrolladores usar para StringBuilder crear una colección de pares clave-valor para poder aprovechar las características incluidas en la DbConnectionStringBuilder clase al agregar pares clave-valor, sin tener que incurrir en la sobrecarga de crear y mantener una DbConnectionStringBuilder instancia. El AppendKeyValuePair método da formato a la clave y el valor correctamente y agrega la nueva cadena al proporcionado StringBuilder.

Consulte también

• Cadenas de conexión de ADO.NET
• Información general de ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Source:

DbConnectionStringBuilder.cs

Proporciona una manera eficaz y segura de anexar una clave y un valor a un objeto StringBuilder existente.

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)

Parámetros

builder

StringBuilder

StringBuilder al que se agrega el par clave/valor.

keyword

String

Clave que se va a agregar.

value

String

Valor de la clave proporcionada.

useOdbcRules

Boolean

true para usar {} para delimitar los campos; false para usar comillas.

Ejemplos

Si algún proceso ha creado un cadena de conexión, pero ahora una aplicación debe realizar una modificación sencilla de esa cadena de conexión, podría ser más eficaz simplemente agregar el par clave-valor mediante un StringBuilder objeto . En lugar de crear un nuevo DbConnectionStringBuilder, los desarrolladores pueden llamar al AppendKeyValuePair método , pasando un StringBuilder objeto que contiene el cadena de conexión proporcionado. En el procedimiento siguiente se muestra un ejemplo sencillo de esta técnica, mediante el uso de reglas ODBC para comillas de valores.

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

Comentarios

Este método permite a los desarrolladores usar para StringBuilder crear una colección de pares clave-valor para poder aprovechar las características incluidas en la DbConnectionStringBuilder clase al agregar pares clave-valor, sin tener que incurrir en la sobrecarga de crear y mantener una DbConnectionStringBuilder instancia. El AppendKeyValuePair método da formato a la clave y el valor correctamente y agrega la nueva cadena al proporcionado StringBuilder.

Aunque la mayoría de los orígenes de datos permiten delimitar campos mediante comillas, ODBC no es para cadenas de conexión ODBC, debe usar llaves ({}). Para tener las DbConnectionStringBuilder reglas ODBC de uso para delimitar campos, establezca el useOdbcRules parámetro trueen .

Consulte también

• Cadenas de conexión de ADO.NET
• Información general de ADO.NET