DbConnectionStringBuilder.AppendKeyValuePair Método

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

Exemplos

Se algum processo criou um cadeia de ligação, mas agora uma aplicação tiver de realizar uma modificação simples nesse cadeia de ligação, pode ser mais eficiente simplesmente adicionar o par chave/valor usando um objeto StringBuilder. Em vez de criar um novo DbConnectionStringBuilder, os programadores podem chamar o método AppendKeyValuePair, passando um StringBuilder que contém o cadeia de ligação fornecido. O procedimento seguinte mostra um exemplo simples desta 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

Observações

Este método permite que os programadores que usam a StringBuilder criem uma coleção de pares chave/valor possam tirar partido das funcionalidades incluídas na DbConnectionStringBuilder classe quando adicionam pares chave/valor, sem terem de incorrer com a sobrecarga de criar e manter uma DbConnectionStringBuilder instância. O AppendKeyValuePair método formata corretamente a chave e o valor e adiciona a nova cadeia ao .StringBuilder

Ver também

• Cadeias de conexão no ADO.NET
• Visão geral 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)

Parâmetros

Exemplos

Se algum processo criou um cadeia de ligação, mas agora uma aplicação tiver de realizar uma modificação simples nesse cadeia de ligação, pode ser mais eficiente simplesmente adicionar o par chave/valor usando um objeto StringBuilder. Em vez de criar um novo DbConnectionStringBuilder, os programadores podem chamar o método AppendKeyValuePair, passando um StringBuilder que contém o cadeia de ligação fornecido. O procedimento seguinte mostra um exemplo simples desta 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

Observações

Este método permite aos programadores StringBuilder criar uma coleção de pares chave/valor para tirar partido das funcionalidades incluídas na DbConnectionStringBuilder classe ao adicionar pares chave/valor, sem terem de incorrer com a sobrecarga de criar e manter uma DbConnectionStringBuilder instância. O AppendKeyValuePair método formata corretamente a chave e o valor e adiciona a nova cadeia ao .StringBuilder

Embora a maioria das fontes de dados permita delimitar campos usando aspas, o ODBC não o faz — para cadeias de ligação ODBC, deve usar colchetes ondulados ({}). Para que as DbConnectionStringBuilder regras ODBC sejam usadas para delimitar campos, defina o useOdbcRules parâmetro para true.

Ver também

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