DbConnectionStringBuilder.AppendKeyValuePair Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

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

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

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ż

• Parametry połączenia w ADO.NET
• Omówienie ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

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

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ż

• Parametry połączenia w ADO.NET
• Omówienie ADO.NET