DbConnectionStringBuilder.AppendKeyValuePair Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Hatékonyan és biztonságosan hozzáfűzhet egy kulcsot és értéket egy meglévő StringBuilder objektumhoz.

Túlterhelések

Name	Description
AppendKeyValuePair(StringBuilder, String, String)	Hatékonyan és biztonságosan hozzáfűzhet egy kulcsot és értéket egy meglévő StringBuilder objektumhoz.
AppendKeyValuePair(StringBuilder, String, String, Boolean)	Hatékonyan és biztonságosan hozzáfűzhet egy kulcsot és értéket egy meglévő StringBuilder objektumhoz.

AppendKeyValuePair(StringBuilder, String, String)

Forrás:

DbConnectionStringBuilder.cs

Hatékonyan és biztonságosan hozzáfűzhet egy kulcsot és értéket egy meglévő StringBuilder objektumhoz.

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)

Paraméterek

builder

StringBuilder

A StringBuilder kulcs/érték pár hozzáadásának célja.

keyword

String

A hozzáadandó kulcs.

value

String

A megadott kulcs értéke.

Példák

Ha egy folyamat létrehozott egy kapcsolati karakterlánc, de most egy alkalmazásnak egyszerű módosítást kell végrehajtania az adott kapcsolati karakterlánc, hatékonyabb lehet csak hozzáadni a kulcs/érték párot egy StringBuilder objektum használatával. Új DbConnectionStringBuilder létrehozása helyett a fejlesztők meghívhatják a AppendKeyValuePair metódust, amely a megadott kapcsolati karakterlánc tartalmazó StringBuilder kerül át. Az alábbi eljárás egy egyszerű példát mutat be erre a technikára.

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

Megjegyzések

Ez a módszer lehetővé teszi a kulcs/érték párok gyűjteményének létrehozását használó StringBuilder fejlesztők számára, hogy kihasználhassák az DbConnectionStringBuilder osztályban található funkciókat kulcs/érték párok hozzáadásakor, anélkül, hogy a példányok létrehozásával és fenntartásával DbConnectionStringBuilder járó többletterhelést kellene vállalniuk. A AppendKeyValuePair metódus megfelelően formázza a kulcsot és az értéket, és hozzáadja az új sztringet a megadotthoz StringBuilder.

Lásd még

• Kapcsolati sztringek a ADO.NET
• ADO.NET áttekintése

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Forrás:

DbConnectionStringBuilder.cs

Hatékonyan és biztonságosan hozzáfűzhet egy kulcsot és értéket egy meglévő StringBuilder objektumhoz.

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)

Paraméterek

builder

StringBuilder

A StringBuilder kulcs/érték pár hozzáadásának célja.

keyword

String

A hozzáadandó kulcs.

value

String

A megadott kulcs értéke.

useOdbcRules

Boolean

true {} mezők elválasztására, false idézőjelek használatára.

Példák

Ha egy folyamat létrehozott egy kapcsolati karakterlánc, de most egy alkalmazásnak egyszerű módosítást kell végrehajtania az adott kapcsolati karakterlánc, hatékonyabb lehet, ha egyszerűen hozzáadja a kulcs/érték párot egy StringBuilder objektum használatával. Új DbConnectionStringBuilder létrehozása helyett a fejlesztők meghívhatják a AppendKeyValuePair metódust, amely a megadott kapcsolati karakterlánc tartalmazó StringBuilder kerül át. Az alábbi eljárás egy egyszerű példát mutat be erre a technikára, amely ODBC-szabályok használatával idézi az értékeket.

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

Megjegyzések

Ez a módszer lehetővé teszi a kulcs/érték párok gyűjteményének létrehozását használó StringBuilder fejlesztők számára, hogy kihasználhassák az DbConnectionStringBuilder osztályban található funkciókat kulcs-érték párok hozzáadásakor, anélkül, hogy a példányok létrehozásával és fenntartásával DbConnectionStringBuilder járó többletterhelést kellene vállalniuk. A AppendKeyValuePair metódus megfelelően formázza a kulcsot és az értéket, és hozzáadja az új sztringet a megadotthoz StringBuilder.

Bár a legtöbb adatforrás lehetővé teszi a mezők idézőjelek használatával történő elhatárolását, az ODBC nem használja az ODBC kapcsolati sztringeket, kapcsos zárójeleket ({}) kell használnia. Annak érdekében, hogy az DbConnectionStringBuilder ODBC-szabályokat használhassa a mezők elválasztásához, állítsa a paramétert a useOdbcRules következőre true: .

Lásd még

• Kapcsolati sztringek a ADO.NET
• ADO.NET áttekintése