DbConnectionStringBuilder.AppendKeyValuePair Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Poskytuje efektivní a bezpečný způsob připojení klíče a hodnoty k existujícímu objektu StringBuilder.

Přetížení

Name	Description
AppendKeyValuePair(StringBuilder, String, String)	Poskytuje efektivní a bezpečný způsob připojení klíče a hodnoty k existujícímu objektu StringBuilder.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Poskytuje efektivní a bezpečný způsob připojení klíče a hodnoty k existujícímu objektu StringBuilder.

AppendKeyValuePair(StringBuilder, String, String)

Zdroj:

DbConnectionStringBuilder.cs

Poskytuje efektivní a bezpečný způsob připojení klíče a hodnoty k existujícímu objektu StringBuilder.

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

Do StringBuilder které se má přidat pár klíč/hodnota.

keyword

String

Klíč, který se má přidat.

value

String

Hodnota zadaného klíče.

Příklady

Pokud nějaký proces vytvořil připojovací řetězec, ale teď musí aplikace provést jednoduchou úpravu této připojovací řetězec, může být efektivnější přidat pár klíč/hodnota pomocí objektu StringBuilder. Místo vytvoření nové DbConnectionStringBuilder můžou vývojáři volat metodu AppendKeyValuePair předáním StringBuilder, která obsahuje zadanou připojovací řetězec. Následující postup ukazuje jednoduchý příklad této techniky.

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

Poznámky

Tato metoda umožňuje vývojářům vytvořit StringBuilder kolekci párů klíč/hodnota, aby mohli využívat funkce zahrnuté ve DbConnectionStringBuilder třídě při přidávání párů klíč/hodnota bez nutnosti vytvářet a udržovat DbConnectionStringBuilder instanci. Metoda AppendKeyValuePair správně formátuje klíč a hodnotu a přidá nový řetězec do zadaného StringBuilder.

Viz také

• Připojovací řetězce v ADO.NET
• Přehled ADO.NET

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Zdroj:

DbConnectionStringBuilder.cs

Poskytuje efektivní a bezpečný způsob připojení klíče a hodnoty k existujícímu objektu StringBuilder.

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

Do StringBuilder které se má přidat pár klíč/hodnota.

keyword

String

Klíč, který se má přidat.

value

String

Hodnota zadaného klíče.

useOdbcRules

Boolean

true {} k oddělovači polí false použijte uvozovky.

Příklady

Pokud nějaký proces vytvořil připojovací řetězec, ale teď musí aplikace provést jednoduchou úpravu této připojovací řetězec, může být efektivnější přidat pár klíč/hodnota pomocí objektu StringBuilder. Místo vytvoření nové DbConnectionStringBuilder můžou vývojáři volat metodu AppendKeyValuePair předáním StringBuilder, která obsahuje zadanou připojovací řetězec. Následující postup ukazuje jednoduchý příklad této techniky pomocí pravidel ODBC pro uvozování hodnot.

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

Poznámky

Tato metoda umožňuje vývojářům vytvořit StringBuilder kolekci párů klíč/hodnota, aby mohli využít výhod funkcí zahrnutých ve DbConnectionStringBuilder třídě při přidávání párů klíč/hodnota, aniž by museli mít režii při vytváření a údržbě DbConnectionStringBuilder instance. Metoda AppendKeyValuePair správně formátuje klíč a hodnotu a přidá nový řetězec do zadaného StringBuilder.

I když většina zdrojů dat umožňuje oddělovat pole pomocí uvozovek, odbc nepoužívá připojovací řetězce ODBC, musíte použít složené závorky ({}). Chcete-li, aby bylo možné použít DbConnectionStringBuilder pravidla ODBC pro oddělovače polí, nastavte useOdbcRules parametr na truehodnotu .

Viz také

• Připojovací řetězce v ADO.NET
• Přehled ADO.NET