DbConnectionStringBuilder.AppendKeyValuePair Metod

Definition

Namnområde:
System.Data.Common
Sammansättning:
System.Data.Common.dll
Sammansättning:
System.Data.dll
Sammansättning:
netstandard.dll

Ger ett effektivt och säkert sätt att lägga till en nyckel och ett värde i ett befintligt StringBuilder objekt.

Överlagringar

Name Description
AppendKeyValuePair(StringBuilder, String, String)

Ger ett effektivt och säkert sätt att lägga till en nyckel och ett värde i ett befintligt StringBuilder objekt.
AppendKeyValuePair(StringBuilder, String, String, Boolean)

Ger ett effektivt och säkert sätt att lägga till en nyckel och ett värde i ett befintligt StringBuilder objekt.

AppendKeyValuePair(StringBuilder, String, String)

Ger ett effektivt och säkert sätt att lägga till en nyckel och ett värde i ett befintligt StringBuilder objekt.

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)

Parametrar

builder
StringBuilder

Till StringBuilder vilket du vill lägga till nyckel/värde-paret.

keyword
String

Nyckeln som ska läggas till.

value
String

Värdet för den angivna nyckeln.

Exempel

Om en process har skapat en reťazec pripojenia, men nu ett program måste utföra en enkel ändring av den reťazec pripojenia, kan det vara mer effektivt att bara lägga till nyckel/värde-paret med hjälp av ett StringBuilder-objekt. I stället för att skapa en ny DbConnectionStringBuilder kan utvecklare anropa metoden AppendKeyValuePair och skicka in en StringBuilder som innehåller den angivna reťazec pripojenia. Följande procedur visar ett enkelt exempel på den här tekniken.

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

Kommentarer

Med den här metoden kan utvecklare använda en StringBuilder för att skapa en samling nyckel/värde-par för att kunna dra nytta av de funktioner som ingår i DbConnectionStringBuilder klassen när du lägger till nyckel/värde-par, utan att behöva dra nytta av kostnaderna för att skapa och underhålla en DbConnectionStringBuilder instans. Metoden AppendKeyValuePair formaterar nyckeln och värdet korrekt och lägger till den nya strängen i den angivna StringBuilder.

Se även

Gäller för

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Ger ett effektivt och säkert sätt att lägga till en nyckel och ett värde i ett befintligt StringBuilder objekt.

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)

Parametrar

builder
StringBuilder

Till StringBuilder vilket du vill lägga till nyckel/värde-paret.

keyword
String

Nyckeln som ska läggas till.

value
String

Värdet för den angivna nyckeln.

useOdbcRules
Boolean

true för att använda {} för att avgränsa fält false för att använda citattecken.

Exempel

Om någon process har skapat en reťazec pripojenia, men nu ett program måste utföra en enkel ändring av den reťazec pripojenia, kan det vara mer effektivt att bara lägga till nyckel/värde-paret med hjälp av ett StringBuilder-objekt. I stället för att skapa en ny DbConnectionStringBuilder kan utvecklare anropa metoden AppendKeyValuePair och skicka in en StringBuilder som innehåller den angivna reťazec pripojenia. Följande procedur visar ett enkelt exempel på den här tekniken med hjälp av ODBC-regler för att citera värden.

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

Kommentarer

Med den här metoden kan utvecklare använda en StringBuilder för att skapa en samling nyckel/värde-par för att kunna dra nytta av de funktioner som ingår i DbConnectionStringBuilder klassen när de lägger till nyckel/värde-par, utan att behöva dra nytta av kostnaderna för att skapa och underhålla en DbConnectionStringBuilder instans. Metoden AppendKeyValuePair formaterar nyckeln och värdet korrekt och lägger till den nya strängen i den angivna StringBuilder.

Även om de flesta datakällor låter dig avgränsa fält med hjälp av citattecken, gör ODBC inte - för ODBC-anslutningssträngar, måste du använda klammerparenteser ({}). För att DbConnectionStringBuilder använda ODBC-regler för att avgränsa fält anger du parametern useOdbcRules till true.

Se även

Gäller för