DbConnectionStringBuilder.AppendKeyValuePair Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Fornece uma maneira eficiente e segura para acrescentar uma chave e um valor a um objeto StringBuilder existente.

Sobrecargas

AppendKeyValuePair(StringBuilder, String, String)	Fornece uma maneira eficiente e segura para acrescentar uma chave e um valor a um objeto StringBuilder existente.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Fornece uma maneira eficiente e segura para acrescentar uma chave e um valor a um objeto StringBuilder existente.

AppendKeyValuePair(StringBuilder, String, String)

Origem:

DbConnectionStringBuilder.cs

Fornece uma maneira eficiente e segura para acrescentar uma chave e um valor a um 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

O StringBuilder ao qual adicionar o par chave-valor.

keyword

String

A chave a ser adicionada.

value

String

O valor para a chave fornecida.

Exemplos

Se algum processo tiver criado um cadeia de conexão, mas agora um aplicativo deve executar uma modificação simples nesse cadeia de conexão, pode ser mais eficiente apenas adicionar o par chave/valor usando um StringBuilder objeto . Em vez de criar um novo DbConnectionStringBuilder, os desenvolvedores podem chamar o AppendKeyValuePair método , passando um StringBuilder que contém o cadeia de conexão fornecido. O procedimento a seguir mostra um exemplo simples dessa 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

Comentários

Esse método permite que os desenvolvedores que usam um StringBuilder para criar uma coleção de pares chave/valor possam aproveitar os recursos incluídos na DbConnectionStringBuilder classe quando você adiciona pares chave/valor, sem precisar incorrer na sobrecarga de criar e manter uma DbConnectionStringBuilder instância. O AppendKeyValuePair método formata a chave e o valor corretamente e adiciona a nova cadeia de caracteres ao fornecido StringBuilder.

Confira também

• Cadeias de conexão no ADO.NET
• Visão geral do ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Origem:

DbConnectionStringBuilder.cs

Fornece uma maneira eficiente e segura para acrescentar uma chave e um valor a um 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

O StringBuilder ao qual adicionar o par chave-valor.

keyword

String

A chave a ser adicionada.

value

String

O valor para a chave fornecida.

useOdbcRules

Boolean

true para usar {} para delimitar campos, false usar aspas.

Exemplos

Se algum processo tiver criado um cadeia de conexão, mas agora um aplicativo precisar executar uma modificação simples nesse cadeia de conexão, talvez seja mais eficiente apenas adicionar o par chave/valor usando um StringBuilder objeto . Em vez de criar um novo DbConnectionStringBuilder, os desenvolvedores podem chamar o AppendKeyValuePair método , passando um StringBuilder que contém o cadeia de conexão fornecido. O procedimento a seguir mostra um exemplo simples dessa técnica, usando regras ODBC para citar 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

Comentários

Esse método permite que os desenvolvedores que usam um StringBuilder para criar uma coleção de pares chave/valor possam aproveitar os recursos incluídos na DbConnectionStringBuilder classe ao adicionar pares chave/valor, sem precisar incorrer na sobrecarga de criar e manter uma DbConnectionStringBuilder instância. O AppendKeyValuePair método formata a chave e o valor corretamente e adiciona a nova cadeia de caracteres ao fornecido StringBuilder.

Embora a maioria das fontes de dados permita que você delimita campos usando aspas, o ODBC não -- para cadeias de conexão ODBC, você deve usar chaves ({}). Para que as DbConnectionStringBuilder regras ODBC usem para delimitar campos, defina o useOdbcRules parâmetro como true.

Confira também

• Cadeias de conexão no ADO.NET
• Visão geral do ADO.NET