Udostępnij za pośrednictwem


DbConnectionStringBuilder.AppendKeyValuePair Metoda

Definicja

Zapewnia wydajny i bezpieczny sposób dołączania klucza i wartości do istniejącego StringBuilder obiektu.

Przeciążenia

AppendKeyValuePair(StringBuilder, String, String)

Zapewnia wydajny i bezpieczny sposób dołączania klucza i wartości do istniejącego StringBuilder obiektu.

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Zapewnia wydajny i bezpieczny sposób dołączania klucza i wartości do istniejącego StringBuilder obiektu.

AppendKeyValuePair(StringBuilder, String, String)

Źródło:
DbConnectionStringBuilder.cs
Źródło:
DbConnectionStringBuilder.cs
Źródło:
DbConnectionStringBuilder.cs

Zapewnia wydajny i bezpieczny sposób dołączania klucza i wartości do istniejącego StringBuilder obiektu.

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);
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)

Parametry

builder
StringBuilder

Element StringBuilder , do którego należy dodać parę klucz/wartość.

keyword
String

Klucz do dodania.

value
String

Wartość podanego klucza.

Przykłady

Jeśli jakiś proces utworzył parametry połączenia, ale teraz aplikacja musi wykonać prostą modyfikację tego parametry połączenia, może to być bardziej wydajne, aby po prostu dodać parę klucz/wartość przy użyciu StringBuilder obiektu. Zamiast tworzyć nowe DbConnectionStringBuilder, deweloperzy mogą wywołać metodęAppendKeyValuePair, przekazując StringBuilder element zawierający podany parametry połączenia. Poniższa procedura przedstawia prosty przykład tej techniki.

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

Uwagi

Ta metoda umożliwia deweloperom tworzenie StringBuilder kolekcji par klucz/wartość w celu korzystania z funkcji uwzględnionych w DbConnectionStringBuilder klasie podczas dodawania par klucz/wartość bez konieczności naliczania kosztów tworzenia i utrzymywania DbConnectionStringBuilder wystąpienia. Metoda AppendKeyValuePair poprawnie formatuje klucz i wartość oraz dodaje nowy ciąg do podanego StringBuilderelementu .

Zobacz też

Dotyczy

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Źródło:
DbConnectionStringBuilder.cs
Źródło:
DbConnectionStringBuilder.cs
Źródło:
DbConnectionStringBuilder.cs

Zapewnia wydajny i bezpieczny sposób dołączania klucza i wartości do istniejącego StringBuilder obiektu.

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);
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)

Parametry

builder
StringBuilder

Element StringBuilder , do którego należy dodać parę klucz/wartość.

keyword
String

Klucz do dodania.

value
String

Wartość podanego klucza.

useOdbcRules
Boolean

true do użycia {} do rozdzielania pól, false aby użyć znaków cudzysłowu.

Przykłady

Jeśli jakiś proces utworzył parametry połączenia, ale teraz aplikacja musi wykonać prostą modyfikację tego parametry połączenia, może to być bardziej wydajne, aby po prostu dodać parę klucz/wartość przy użyciu StringBuilder obiektu. Zamiast tworzyć nowe DbConnectionStringBuilder, deweloperzy mogą wywołać metodęAppendKeyValuePair, przekazując StringBuilder element zawierający podany parametry połączenia. Poniższa procedura przedstawia prosty przykład tej techniki przy użyciu reguł ODBC do cytowania wartości.

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

Uwagi

Ta metoda umożliwia deweloperom tworzenie StringBuilder kolekcji par klucz/wartość w celu korzystania z funkcji uwzględnionych w DbConnectionStringBuilder klasie podczas dodawania par klucz/wartość bez konieczności naliczania kosztów związanych z tworzeniem DbConnectionStringBuilder i konserwacją wystąpienia. Metoda AppendKeyValuePair poprawnie formatuje klucz i wartość oraz dodaje nowy ciąg do podanego StringBuilderelementu .

Chociaż większość źródeł danych pozwala rozdzielać pola przy użyciu cudzysłowów, funkcja ODBC nie obsługuje parametrów połączenia ODBC, należy użyć nawiasów klamrowych ({}). Aby używać DbConnectionStringBuilder reguł ODBC do rozdzielania pól, ustaw useOdbcRules parametr na true.

Zobacz też

Dotyczy