Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SqlConnectionStringBuilder-Klasse

 

Veröffentlicht: August 2016

Bietet eine einfache Möglichkeit, den Inhalt von Verbindungszeichenfolgen, die von der SqlConnection-Klasse verwendet werden, zu erstellen und zu verwalten.

Namespace:   System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)

System.Object
  System.Data.Common.DbConnectionStringBuilder
    System.Data.SqlClient.SqlConnectionStringBuilder

public sealed class SqlConnectionStringBuilder : DbConnectionStringBuilder

NameBeschreibung
System_CAPS_pubmethodSqlConnectionStringBuilder()

Initialisiert eine neue Instanz der SqlConnectionStringBuilder-Klasse.

System_CAPS_pubmethodSqlConnectionStringBuilder(String)

Initialisiert eine neue Instanz der SqlConnectionStringBuilder-Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

NameBeschreibung
System_CAPS_pubpropertyApplicationIntent

Deklariert den Arbeitsauslastungstyp für die Anwendung, wenn eine Verbindung mit einer Datenbank in einer SQL Server-Verfügbarkeitsgruppe hergestellt wird. Sie können den Wert der Eigenschaft mit ApplicationIntent festlegen. Weitere Informationen zu SqlClient-Unterstützung für AlwaysOn-Verfügbarkeitsgruppen finden Sie unter SqlClient-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.

System_CAPS_pubpropertyApplicationName

Ruft den Namen der Verbindungszeichenfolge zugeordneten Anwendung ab oder legt einen Namen fest.

System_CAPS_pubpropertyAsynchronousProcessing

Ruft einen booleschen Wert ab, der angibt, ob die mit dieser Verbindungszeichenfolge erstellte Verbindung eine asynchrone Verarbeitung zulässt.

System_CAPS_pubpropertyAttachDBFilename

Ruft eine Zeichenfolge ab, die den Namen der Primärdatendatei enthält, oder legt diese Zeichenfolge fest. Dazu gehört der vollständige Pfadname einer anfügbaren Datenbank.

System_CAPS_pubpropertyAuthentication

Ruft die Authentifizierung der Verbindungszeichenfolge ab.

System_CAPS_pubpropertyBrowsableConnectionString

Ruft einen Wert ab, der angibt, ob die ConnectionString-Eigenschaft in Visual Studio-Designern sichtbar ist, oder legt diesen Wert fest.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubpropertyColumnEncryptionSetting

Ruft die Spaltenverschlüsselungseinstellungen für den Verbindungszeichenfolgen-Generator ab und legt diese fest.

System_CAPS_pubpropertyConnectionReset

Veraltet. Veraltet. Ruft einen booleschen Wert ab, der angibt, ob die Verbindung bei der Entnahme aus dem Verbindungspool zurückgesetzt wird, oder legt diesen Wert fest.

System_CAPS_pubpropertyConnectionString

Ruft die dem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge ab oder legt sie fest.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubpropertyConnectRetryCount

[Wird nur in .NET Framework 4.5.1 und neueren Versionen unterstützt]

Die Anzahl der erneuten Verbindungsversuche, nachdem ermittelt wurde, dass ein Fehler aufgrund einer Leerlaufverbindung erkannt wurde. Dieser muss einer ganzen Zahl zwischen 0 und 255 entsprechen. Der Standardwert ist 1. Legen Sie den Wert auf 0 fest, um das Herstellen einer erneuten Verbindung bei Fehlern aufgrund einer Leerlaufverbindung zu deaktivieren. Bei Verwendung eines Werts außerhalb des zulässigen Bereichs wird eine ArgumentException ausgelöst.

System_CAPS_pubpropertyConnectRetryInterval

[Wird nur in .NET Framework 4.5.1 und neueren Versionen unterstützt]

Zeitraum zwischen erneuten Verbindungsversuchen (in Sekunden), nachdem ein Fehler aufgrund einer Leerlaufverbindung erkannt wurde. Dieser muss einer ganzen Zahl zwischen 1 und 60 entsprechen. Der Standardwert ist 10 Sekunden. Bei Verwendung eines Werts außerhalb des zulässigen Bereichs wird eine ArgumentException ausgelöst.

System_CAPS_pubpropertyConnectTimeout

Ruft die Zeit in Sekunden ab, die auf eine Verbindung zum Server gewartet werden soll, bevor der Versuch abgebrochen und ein Fehler generiert wird, oder legt diesen Wert fest.

System_CAPS_pubpropertyContextConnection

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob eine Client-/Server-Verbindung oder eine prozessinterne Verbindung zu SQL Server hergestellt werden soll.

System_CAPS_pubpropertyCount

Ruft die aktuelle Anzahl von Schlüsseln ab, die in der ConnectionString-Eigenschaft enthalten sind.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubpropertyCurrentLanguage

Ruft den Datensatznamen der SQL Server-Sprache ab oder legt ihn fest.

System_CAPS_pubpropertyDataSource

Ruft den Namen oder die Netzwerkadresse der Instanz von SQL Server ab, mit der eine Verbindung hergestellt werden soll, oder legt einen Namen bzw. eine Adresse fest.

System_CAPS_pubpropertyEncrypt

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob alle zwischen Client und Server gesendeten Daten von SQL Server eine SSL-Verschlüsselung verwenden, sofern auf dem Server ein Zertifikat installiert ist.

System_CAPS_pubpropertyEnlist

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob der Verbindungspooler in SQL Server die Verbindung automatisch in den aktuellen Transaktionskontext des Erstellungsthreads einträgt.

System_CAPS_pubpropertyFailoverPartner

Ruft den Namen oder die Adresse des Partnerservers ab (bzw. legt diese Angaben fest), mit dem eine Verbindung hergestellt werden soll, wenn der primäre Server ausgefallen ist.

System_CAPS_pubpropertyInitialCatalog

Ruft den Namen der Datenbank ab, die der Verbindung zugeordnet ist, oder legt einen Namen fest.

System_CAPS_pubpropertyIntegratedSecurity

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob in der Verbindung eine Benutzer-ID und ein Kennwort angegeben wurden (dann false) oder ob zur Authentifizierung die aktuellen Anmeldeinformationen des Windows-Kontos verwendet werden (dann true).

System_CAPS_pubpropertyIsFixedSize

Ruft einen Wert ab, der angibt, ob die SqlConnectionStringBuilder eine feste Größe hat.(Überschreibt DbConnectionStringBuilder.IsFixedSize.)

System_CAPS_pubpropertyIsReadOnly

Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubpropertyItem[String]

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der Indexer.(Überschreibt DbConnectionStringBuilder.Item[String].)

System_CAPS_pubpropertyKeys

Ruft eine ICollection ab, die die Schlüssel im SqlConnectionStringBuilder enthält.(Überschreibt DbConnectionStringBuilder.Keys.)

System_CAPS_pubpropertyLoadBalanceTimeout

Ruft für die Verbindung die minimale Zeitdauer in Sekunden ab, die sie im Verbindungspool verbleiben soll, oder legt diese Zeitdauer fest.

System_CAPS_pubpropertyMaxPoolSize

Ruft die maximale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.

System_CAPS_pubpropertyMinPoolSize

Ruft die minimale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.

System_CAPS_pubpropertyMultipleActiveResultSets

Bei „true“ kann eine Anwendung mehrere aktive Resultsets (Multiple Active Result Sets, MARS) verwalten. Ist diese Option auf „false“ festgelegt, muss eine Anwendung alle Resultsets aus einem Batch verarbeiten oder abbrechen, bevor der nächste Batch für diese Verbindung ausgeführt werden kann.

Weitere Informationen finden Sie unter Multiple Active Result Sets (MARS).

System_CAPS_pubpropertyMultiSubnetFailover

Wenn die Anwendung in verschiedenen Subnetzen eine Verbindung mit einer AlwaysOn-Verfügbarkeitsgruppe herstellt, ermöglicht die Festlegung von MultiSubnetFailover=true die schnellere Erkennung des (derzeit) aktiven Servers sowie eine Verbindung mit dem Server. Weitere Informationen zu SqlClient-Unterstützung für AlwaysOn-Verfügbarkeitsgruppen finden Sie unter SqlClient-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.

System_CAPS_pubpropertyNetworkLibrary

Ruft eine Zeichenfolge ab oder legt eine fest, die den Namen der Netzwerkbibliothek enthält, mit der die Verbindung zu SQL Server hergestellt wird.

System_CAPS_pubpropertyPacketSize

Ruft die Größe der Netzwerkpakete in Bytes ab, die zum Kommunizieren mit einer Instanz von SQL Server verwendet werden, oder legt die Größe fest.

System_CAPS_pubpropertyPassword

Ruft das Kennwort für das SQL Server-Konto ab oder legt es fest.

System_CAPS_pubpropertyPersistSecurityInfo

Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob sicherheitsrelevante Informationen, z. B. das Kennwort, nicht als Teil der Verbindung zurückgegeben werden, wenn die Verbindung geöffnet ist oder sich jemals im geöffneten Zustand befunden hat.

System_CAPS_pubpropertyPoolBlockingPeriod

Das Verhalten im Blockierungszeitraum für einen Verbindungspool.

System_CAPS_pubpropertyPooling

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob die Verbindung bei jedem Aufruf in den Verbindungspool gestellt oder explizit geöffnet wird.

System_CAPS_pubpropertyReplication

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob mit der Verbindung Replikationsvorgänge unterstützt werden.

System_CAPS_pubpropertyTransactionBinding

Ruft einen Zeichenfolgenwert ab, der angibt, wie die Verbindung ihre Zuordnung zu einer eingetragenen System.Transactions-Transaktion beibehält, oder legt diesen Wert fest.

System_CAPS_pubpropertyTransparentNetworkIPResolution

Wenn der Wert dieses Schlüssels auf festgelegt ist true, die Anwendung ist erforderlich, um alle IP-Adressen für einen bestimmten DNS-Eintrag abzurufen, und versuchen Sie für die Verbindung mit der ersten Anweisung in der Liste. Wenn die Verbindung nicht innerhalb von 0,5 Sekunden hergestellt wird, versucht die Anwendung zur Verbindung mit allen anderen parallel. Wenn die erste annimmt, wird die Anwendung die Verbindung mit der %w% IP-Adresse herstellen.

System_CAPS_pubpropertyTrustServerCertificate

Ruft einen Wert ab, der angibt, ob der Channel verschlüsselt wird, während das Durchlaufen der Zertifikatskette zum Überprüfen der Vertrauensstellung übergangen wird.

System_CAPS_pubpropertyTypeSystemVersion

Ruft einen Zeichenfolgenwert ab, der das Typensystem angibt, dass die Anwendung erwartet, oder legt diesen fest.

System_CAPS_pubpropertyUserID

Ruft die Benutzer-ID ab, die zum Herstellen einer SQL Server-Verbindung verwendet wird, oder legt diese fest.

System_CAPS_pubpropertyUserInstance

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Verbindung von der Standardinstanz von SQL Server Express auf eine von der Laufzeit initiierte Instanz umgeleitet werden soll, die unter dem Konto des Aufrufers ausgeführt wird.

System_CAPS_pubpropertyValues

Ruft ein ICollection ab, das die Werte im SqlConnectionStringBuilder enthält.(Überschreibt DbConnectionStringBuilder.Values.)

System_CAPS_pubpropertyWorkstationID

Ruft den Namen der Workstation fest, die eine Verbindung zu SQL Server herstellt, oder legt den Namen fest.

NameBeschreibung
System_CAPS_pubmethodAdd(String, Object)

Fügt dem DbConnectionStringBuilder einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubmethodClear()

Löscht den Inhalt der SqlConnectionStringBuilder-Instanz.(Überschreibt DbConnectionStringBuilder.Clear().)

System_CAPS_protmethodClearPropertyDescriptors()

Löscht die Auflistung von PropertyDescriptor-Objekten, die dem DbConnectionStringBuilder zugeordnet sind.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubmethodContainsKey(String)

Stellt fest, ob der SqlConnectionStringBuilder einen bestimmten Schlüssel enthält.(Überschreibt DbConnectionStringBuilder.ContainsKey(String).)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodEquivalentTo(DbConnectionStringBuilder)

Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen Objekt.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodRemove(String)

Entfernt den Eintrag mit dem angegebenen Schlüssel aus der SqlConnectionStringBuilder-Instanz.(Überschreibt DbConnectionStringBuilder.Remove(String).)

System_CAPS_pubmethodShouldSerialize(String)

Gibt an, ob der angegebene Schlüssel in dieser SqlConnectionStringBuilder-Instanz vorhanden ist.(Überschreibt DbConnectionStringBuilder.ShouldSerialize(String).)

System_CAPS_pubmethodToString()

Gibt die diesem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubmethodTryGetValue(String, Object)

Ruft einen Wert ab, der dem von diesem SqlConnectionStringBuilder bereitgestellten Schlüssel entspricht.(Überschreibt DbConnectionStringBuilder.TryGetValue(String, Object).)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Kopiert die Elemente der ICollection in ein Array, beginnend bei einem bestimmten Array-Index.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Add(Object, Object)

Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Contains(Object)

Ermittelt, ob das IDictionary-Objekt ein Element mit dem angegebenen Schlüssel enthält.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.GetEnumerator()

Gibt ein IDictionaryEnumerator-Objekt für das IDictionary-Objekt zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Remove(Object)

Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary-Objekt.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchläuft.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetAttributes()

Gibt eine Auflistung benutzerdefinierter Attribute für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetClassName()

Gibt den Klassennamen dieser Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetComponentName()

Gibt den Namen dieser Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetConverter()

Gibt einen Typkonverter für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetDefaultEvent()

Gibt das Standardereignis für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetDefaultProperty()

Gibt die Standardeigenschaft für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEditor(Type)

Gibt einen Editor des angegebenen Typs für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEvents()

Gibt die Ereignisse für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEvents(Attribute[])

Gibt die Ereignisse für diese Instanz einer Komponente zurück, wobei das angegebene Attributarray als Filter verwendet wird.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetProperties()

Gibt die Eigenschaften für diese Instanz einer Komponente zurück.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetProperties(Attribute[])

Gibt die Eigenschaften für diese Instanz einer Komponente zurück, wobei das Attributarray als Filter verwendet wird.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Gibt ein Objekt zurück, das die Eigenschaft enthält, die durch den Eigenschaftendeskriptor angegeben ist.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann.(Geerbt von „DbConnectionStringBuilder“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDictionary.Item[Object]

Ruft das Element mit dem angegebenen Schlüssel ab oder legt dieses fest.(Geerbt von „DbConnectionStringBuilder“.)

NameBeschreibung
System_CAPS_pubmethodAsParallel()

Überladen. Ermöglicht die Parallelisierung einer Abfrage.(Definiert durch ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Überladen. Konvertiert ein IEnumerable zu einer IQueryable.(Definiert durch Queryable.)

System_CAPS_pubmethodCast<TResult>()

Wandelt die Elemente einer IEnumerable in den angegebenen Typ.(Definiert durch Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtert die Elemente einer IEnumerable auf Grundlage eines angegebenen Typs.(Definiert durch Enumerable.)

Mithilfe des Verbindungszeichenfolgen-Generators können Entwickler syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen sowie vorhandene Verbindungszeichenfolgen analysieren und neu erstellen, indem sie Eigenschaften und Methoden der Klasse verwenden. Der Verbindungszeichenfolgen-Generator stellt stark typisierte Eigenschaften mit strikter Typbindung bereit, die den bekannten Schlüssel-Wert-Paaren entsprechen, die von SQL Server zugelassen werden. Entwickler, die Verbindungszeichenfolgen als Teil von Anwendungen erstellen müssen, können die SqlConnectionStringBuilder-Klasse verwenden, um Verbindungszeichenfolgen zu erstellen und zu ändern. Die Klasse vereinfacht auch die Verwaltung von Verbindungszeichenfolgen, die in einer Anwendungskonfigurationsdatei gespeichert sind.

Der SqlConnectionStringBuilder führt Überprüfungen auf gültige Schlüssel-Wert-Paare aus. Daher können mit dieser Klasse keine ungültigen Verbindungszeichenfolgen erstellt werden. Wenn Sie versuchen, ungültige Paare hinzuzufügen, wird eine Ausnahme ausgelöst. Die Klasse verwaltet eine feste Sammlung von Synonymen und ist in der Lage, ein Synonym in den entsprechenden bekannten Schlüsselnamen zu übersetzen.

Z. B. bei Verwendung der Element Eigenschaft zum Abrufen eines Werts können Sie eine Zeichenfolge, ein Synonym für den Schlüssel enthält, Sie müssen, angeben. Angenommen, Sie können angeben "Netzwerkadresse", "ADR" oder anderes geeignetes Synonym für diesen Schlüssel in einer Verbindungszeichenfolge, wenn Sie einen Member verwenden, die eine Zeichenfolge erfordert, die den Schlüsselnamen, z. B. beinhaltet die Element Eigenschaft oder die Remove Methode. In der ConnectionString-Eigenschaft finden Sie eine vollständige Liste der akzeptablen Synonyme.

Die Element -Eigenschaft behandelt Versuche zur Einfügung von böswilligen Einträgen. Beispiel: Der folgende Code, in dem die standardmäßige Item-Eigenschaft verwendet wird (der Indexer in C#) versieht das geschachtelte Schlüssel-Wert-Paar ordnungsgemäß mit Escapezeichen:

[Visual Basic]

Dim builder As New System.Data.SqlClient.SqlConnectionStringBuilder
builder("Data Source") = "(local)"
builder("Integrated Security") = True
builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"
Console.WriteLine(builder.ConnectionString)

[C#]

System.Data.SqlClient.SqlConnectionStringBuilder builder =
  new System.Data.SqlClient.SqlConnectionStringBuilder();
builder["Data Source"] = "(local)";
builder["integrated Security"] = true;
builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";
Console.WriteLine(builder.ConnectionString);

Das Ergebnis ist die folgende Verbindungszeichenfolge, die den ungültigen Wert sicher behandelt:

Source=(local);Initial Catalog="AdventureWorks;NewValue=Bad";
Integrated Security=True

Die folgende Konsolenanwendung erstellt, die Verbindungszeichenfolgen für eine SQL Server Datenbank. Der Code verwendet eine SqlConnectionStringBuilder-Klasse zum Erstellen der Verbindungszeichenfolge und übergibt anschließend die ConnectionString-Eigenschaft der SqlConnectionStringBuilder-Instanz an den Konstruktor der Verbindungsklasse. In dem Beispiel wird auch eine vorhandene Verbindungszeichenfolge analysiert, und es werden verschiedene Methoden zur Bearbeitung des Inhalts der Verbindungszeichenfolge veranschaulicht.

System_CAPS_noteHinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von SqlConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

using System.Data;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        // Create a new SqlConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());

        // The input connection string used the 
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the SqlConnectionStringBuilder an existing 
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=(local);user id=ab;" +
            "password= a!Pass113;initial catalog=AdventureWorks";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "new@1Password";
        builder.AsynchronousProcessing = true;

        // You can refer to connection keys using strings, 
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Connect Timeout"] = 1000;
        builder["Trusted_Connection"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file. 
        return "Server=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks";
    }
}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: