DbConnectionStringBuilder.AppendKeyValuePair Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

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

Přetížení

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

AppendKeyValuePair(StringBuilder, String, String)

Zdroj:

DbConnectionStringBuilder.cs

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

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

Hodnota StringBuilder , do které chcete 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 změnu této připojovací řetězec, může být efektivnější přidat pár klíč-hodnota pomocí objektuStringBuilder. Místo vytváření nového DbConnectionStringBuildermohou vývojáři volat metodu AppendKeyValuePair a předat metodu , která obsahuje zadanou StringBuilder 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 použít StringBuilder k vytvoření kolekce párů klíč/hodnota, aby mohli využívat funkce zahrnuté ve DbConnectionStringBuilder třídě při přidávání párů klíč/hodnota, aniž by se musely účtovat režijní náklady spojené s vytvářením a údržbou DbConnectionStringBuilder instance. 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 StringBuilder objektu.

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

Hodnota StringBuilder , do které chcete 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ělení polí použijte false uvozovky.

Příklady

Pokud nějaký proces vytvořil připojovací řetězec, ale teď musí aplikace provést jednoduchou úpravu připojovací řetězec, může být efektivnější přidat pár klíč-hodnota pomocí objektuStringBuilder. Místo vytváření nového DbConnectionStringBuildermohou vývojáři volat metodu AppendKeyValuePair a předat metodu , která obsahuje zadanou StringBuilder 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 při přidávání párů klíč/hodnota využívat funkce zahrnuté ve DbConnectionStringBuilder třídě, aniž by museli vzniknout režijní náklady spojené s vytvářením a údržbou 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 uvozovkami, ROZHRANÍ ODBC nikoli – pro připojovací řetězce ODBC je nutné použít složené závorky ({}). Pokud chcete DbConnectionStringBuilder použít pravidla ODBC pro oddělovač polí, nastavte useOdbcRules parametr na true.

Viz také

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