DbConnectionStringBuilder.AppendKeyValuePair Methode

Definitie

Naamruimte:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Biedt een efficiënte en veilige manier om een sleutel en waarde toe te voegen aan een bestaand StringBuilder object.

Overloads

Name Description
AppendKeyValuePair(StringBuilder, String, String)

Biedt een efficiënte en veilige manier om een sleutel en waarde toe te voegen aan een bestaand StringBuilder object.
AppendKeyValuePair(StringBuilder, String, String, Boolean)

Biedt een efficiënte en veilige manier om een sleutel en waarde toe te voegen aan een bestaand StringBuilder object.

AppendKeyValuePair(StringBuilder, String, String)

Biedt een efficiënte en veilige manier om een sleutel en waarde toe te voegen aan een bestaand StringBuilder object.

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)

Parameters

builder
StringBuilder

Het StringBuilder sleutel-waardepaar waaraan moet worden toegevoegd.

keyword
String

De sleutel die moet worden toegevoegd.

value
String

De waarde voor de opgegeven sleutel.

Voorbeelden

Als een bepaald proces een verbindingsreeks heeft gemaakt, maar nu een toepassing een eenvoudige wijziging moet uitvoeren op die verbindingsreeks, kan het efficiënter zijn om alleen het sleutel-/waardepaar toe te voegen met behulp van een StringBuilder-object. In plaats van een nieuwe DbConnectionStringBuilder te maken, kunnen ontwikkelaars de methode AppendKeyValuePair aanroepen, waarbij een StringBuilder wordt doorgegeven die de opgegeven verbindingsreeks bevat. In de volgende procedure ziet u een eenvoudig voorbeeld van deze techniek.

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

Opmerkingen

Met deze methode kunnen ontwikkelaars een StringBuilder verzameling sleutel-waardeparen maken om te kunnen profiteren van de functies die in de DbConnectionStringBuilder klasse zijn opgenomen wanneer u sleutel-waardeparen toevoegt, zonder dat er overhead nodig is voor het maken en onderhouden van een DbConnectionStringBuilder exemplaar. De AppendKeyValuePair methode maakt de sleutel en waarde correct op en voegt de nieuwe tekenreeks toe aan de opgegeven StringBuilder.

Zie ook

Van toepassing op

AppendKeyValuePair(StringBuilder, String, String, Boolean)

Biedt een efficiënte en veilige manier om een sleutel en waarde toe te voegen aan een bestaand StringBuilder object.

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)

Parameters

builder
StringBuilder

Het StringBuilder sleutel-waardepaar waaraan moet worden toegevoegd.

keyword
String

De sleutel die moet worden toegevoegd.

value
String

De waarde voor de opgegeven sleutel.

useOdbcRules
Boolean

true als u wilt gebruiken {} om velden te scheiden, false als u aanhalingstekens wilt gebruiken.

Voorbeelden

Als een bepaald proces een verbindingsreeks heeft gemaakt, maar nu een toepassing een eenvoudige wijziging moet uitvoeren op die verbindingsreeks, kan het efficiënter zijn om alleen het sleutel-/waardepaar toe te voegen met behulp van een StringBuilder-object. In plaats van een nieuwe DbConnectionStringBuilder te maken, kunnen ontwikkelaars de methode AppendKeyValuePair aanroepen, waarbij een StringBuilder wordt doorgegeven die de opgegeven verbindingsreeks bevat. In de volgende procedure ziet u een eenvoudig voorbeeld van deze techniek, met behulp van ODBC-regels voor het aanhalen van waarden.

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

Opmerkingen

Met deze methode kunnen ontwikkelaars een StringBuilder verzameling sleutel-/waardeparen maken om te kunnen profiteren van de functies die in de DbConnectionStringBuilder klasse zijn opgenomen bij het toevoegen van sleutel-waardeparen, zonder dat er overhead nodig is voor het maken en onderhouden van een DbConnectionStringBuilder exemplaar. De AppendKeyValuePair methode maakt de sleutel en waarde correct op en voegt de nieuwe tekenreeks toe aan de opgegeven StringBuilder.

Hoewel in de meeste gegevensbronnen velden kunnen worden gescheiden met aanhalingstekens, hoeft ODBC geen ODBC-verbindingsreeksen te gebruiken, moet u accolades ({}) gebruiken. Als u DbConnectionStringBuilder ODBC-regels wilt gebruiken voor het scheiden van velden, stelt u de useOdbcRules parameter in op true.

Zie ook

Van toepassing op