DbConnectionStringBuilder.AppendKeyValuePair Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma maneira eficiente e segura de acrescentar uma chave e um valor a um objeto StringBuilder existente.
Sobrecargas
| Nome | Description |
|---|---|
| AppendKeyValuePair(StringBuilder, String, String) |
Fornece uma maneira eficiente e segura de acrescentar uma chave e um valor a um objeto StringBuilder existente. |
| AppendKeyValuePair(StringBuilder, String, String, Boolean) |
Fornece uma maneira eficiente e segura de acrescentar uma chave e um valor a um objeto StringBuilder existente. |
AppendKeyValuePair(StringBuilder, String, String)
Fornece uma maneira eficiente e segura de 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
Ao StringBuilder qual adicionar o par chave/valor.
- keyword
- String
A chave a ser adicionada.
- value
- String
O valor da 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 objeto StringBuilder. Em vez de criar um novo DbConnectionStringBuilder, os desenvolvedores podem chamar o método AppendKeyValuePair, 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 uma StringBuilder 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.
Confira também
Aplica-se a
AppendKeyValuePair(StringBuilder, String, String, Boolean)
Fornece uma maneira eficiente e segura de 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
Ao StringBuilder qual adicionar o par chave/valor.
- keyword
- String
A chave a ser adicionada.
- value
- String
O valor da chave fornecida.
- useOdbcRules
- Boolean
true para usar {} para delimitar campos, false para usar aspas.
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, talvez seja mais eficiente apenas adicionar o par chave/valor usando um objeto StringBuilder. Em vez de criar um novo DbConnectionStringBuilder, os desenvolvedores podem chamar o método AppendKeyValuePair, 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 aspas.
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 uma StringBuilder 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 de uso sejam usadas para delimitar campos, defina o useOdbcRules parâmetro como true.