SqlConnection.ConnectionString Eigenschaft

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Ruft die Zeichenfolge ab, mit der eine SQL Server-Datenbank geöffnet wird, oder legt diese fest.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Eigenschaftswert

String

Die Verbindungszeichenfolge, die den Namen der Quelldatenbank und weitere für das Herstellen der Anfangsverbindung erforderliche Parameter enthält. Der Standardwert ist eine leere Zeichenfolge.

Ausnahmen

ArgumentException

Es wurde ein ungültiges Argument für eine Verbindungszeichenfolge bereitgestellt, oder ein erforderliches Argument für eine Verbindungszeichenfolge wurde nicht bereitgestellt.

Beispiele

Im folgenden Beispiel wird ein SqlConnection erstellt und die ConnectionString -Eigenschaft festgelegt, bevor die Verbindung geöffnet wird.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

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

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Hinweise

Der ConnectionString ähnelt einem OLE DB-Verbindungszeichenfolge, ist aber nicht identisch. Im Gegensatz zu OLE DB oder ADO ist der zurückgegebene Verbindungszeichenfolge mit dem Benutzersatz ConnectionStringidentisch, abzüglich der Sicherheitsinformationen, wenn der Wert Persist Security Info auf false (Standard) festgelegt ist. Der .NET Framework-Datenanbieter für SQL Server speichert oder gibt das Kennwort nicht in einer Verbindungszeichenfolge zurück, es sei denn, Sie legen Persist Security Info auf festtrue.

Sie können die ConnectionString -Eigenschaft verwenden, um eine Verbindung mit einer Datenbank herzustellen. Das folgende Beispiel veranschaulicht eine typische Verbindungszeichenfolge.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Verwenden Sie das neue SqlConnectionStringBuilder , um gültige Verbindungszeichenfolgen zur Laufzeit zu erstellen. Weitere Informationen finden Sie in Connection String Builders (Verbindungszeichenfolgengeneratoren).

Die ConnectionString -Eigenschaft kann nur festgelegt werden, wenn die Verbindung geschlossen wird. Viele der Verbindungszeichenfolge-Werte verfügen über entsprechende schreibgeschützte Eigenschaften. Wenn die Verbindungszeichenfolge festgelegt ist, werden diese Eigenschaften aktualisiert, es sei denn, es wird ein Fehler erkannt. In diesem Fall wird keine der Eigenschaften aktualisiert. SqlConnection -Eigenschaften geben nur die Einstellungen zurück, die ConnectionStringin enthalten sind.

Um eine Verbindung mit einem lokalen Computer herzustellen, geben Sie "(local)" für den Server an. Wenn kein Servername angegeben wird, wird versucht, eine Verbindung mit dem Standard-instance auf dem lokalen Computer herzustellen.

Beim Zurücksetzen von für ConnectionString eine geschlossene Verbindung werden alle Verbindungszeichenfolge Werte (und zugehörige Eigenschaften) zurückgesetzt, einschließlich des Kennworts. Wenn Sie beispielsweise eine Verbindungszeichenfolge festlegen, die "Database= AdventureWorks" enthält, und dann die Verbindungszeichenfolge auf "Datenquelle=meinserver; Integrated Security=true", ist die Database Eigenschaft nicht mehr auf "AdventureWorks" festgelegt.

Die Verbindungszeichenfolge wird sofort nach dem Festlegen analysiert. Wenn beim Analysieren Syntaxfehler gefunden werden, wird eine Laufzeit-Ausnahme, z ArgumentException. B. , generiert. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das Basisformat eines Verbindungszeichenfolge enthält eine Reihe von Schlüsselwort (keyword)-Wert-Paaren, die durch Semikolons getrennt sind. Ein Gleichheitszeichen (=) verbindet jedes Schlüsselwort mit seinem Wert. Um Werte einzuschließen, die ein Semikolon, Ein-Anführungszeichen oder doppeltes Anführungszeichen enthalten, muss der Wert in doppelte Anführungszeichen eingeschlossen werden. Wenn der Wert sowohl ein Semikolon als auch ein Zeichen mit doppeltem Anführungszeichen enthält, kann der Wert in einfache Anführungszeichen eingeschlossen werden. Das einfache Anführungszeichen ist auch nützlich, wenn der Wert mit einem Zeichen mit doppeltem Anführungszeichen beginnt. Umgekehrt kann das doppelte Anführungszeichen verwendet werden, wenn der Wert mit einem einzigen Anführungszeichen beginnt. Wenn der Wert sowohl Anführungszeichen als auch Anführungszeichen mit doppeltem Anführungszeichen enthält, muss das Anführungszeichen, das zum Einschließen des Werts verwendet wird, jedes Mal verdoppelt werden, wenn er innerhalb des Werts auftritt.

Um vorangehende oder nachfolgende Leerzeichen in den Zeichenfolgenwert einzuschließen, muss der Wert entweder in einfache Anführungszeichen oder doppelte Anführungszeichen eingeschlossen werden. Alle führenden oder nachfolgenden Leerzeichen um ganzzahlige, boolesche oder aufgezählte Werte werden ignoriert, auch wenn sie in Anführungszeichen eingeschlossen sind. Leerzeichen innerhalb eines Zeichenfolgenliterals Schlüsselwort (keyword) oder -Werts bleiben jedoch erhalten. Einzelne oder doppelte Anführungszeichen können innerhalb eines Verbindungszeichenfolge ohne Trennzeichen verwendet werden (z. B. Data Source= my'Server oder Data Source= my"Server), es sei denn, ein Anführungszeichen ist das erste oder letzte Zeichen im Wert.

Bei Schlüsselwörtern wird die Groß-/Kleinschreibung nicht beachtet.

In der folgenden Tabelle sind die gültigen Namen für Schlüsselwort (keyword) Werte in aufgeführtConnectionString.

Stichwort	Standard	BESCHREIBUNG
Addr	Nicht zutreffend	Synonym für Datenquelle.
Adresse	–	Synonym für Datenquelle.
App	Nicht zutreffend	Synonym für Anwendungsname.
Anwendungsname	Nicht zutreffend	Der Name der Anwendung oder ".NET SQLClient-Datenanbieter", wenn kein Anwendungsname angegeben wird. Ein Anwendungsname kann maximal 128 Zeichen lang sein.
ApplicationIntent	ReadWrite	Deklariert den Arbeitsauslastungstyp der Anwendung beim Herstellen einer Verbindung mit einem Server. Mögliche Werte sind ReadOnly und ReadWrite. Beispiel: ApplicationIntent=ReadOnly Weitere Informationen zur SqlClient-Unterstützung für AlwaysOn-Verfügbarkeitsgruppen finden Sie unter SqlClient-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.
Asynchronous Processing - oder - Async	"false"	Wenn trueaktiviert wird, wird die Unterstützung für asynchrone Vorgänge aktiviert. Erkannte Werte sind true, false, yes und no. Diese Eigenschaft wird ab .NET Framework 4.5 ignoriert. Weitere Informationen zur SqlClient-Unterstützung für die asynchrone Programmierung finden Sie unter Asynchrone Programmierung.
AttachDBFilename - oder - Extended Properties - oder - Anfangsdateiname	Nicht zutreffend	Der Name der primären Datenbankdatei, einschließlich des vollständigen Pfadnamens einer anfügenden Datenbank. AttachDBFilename wird nur für primäre Datendateien mit einer MDF-Erweiterung unterstützt. Wenn der Wert des AttachDBFileName-Schlüssels im Verbindungszeichenfolge angegeben wird, wird die Datenbank angefügt und wird zur Standarddatenbank für die Verbindung. Wenn dieser Schlüssel nicht angegeben ist und die Datenbank zuvor angefügt wurde, wird die Datenbank nicht erneut angefügt. Die zuvor angefügte Datenbank wird als Standarddatenbank für die Verbindung verwendet. Wenn dieser Schlüssel zusammen mit dem Schlüssel AttachDBFileName angegeben wird, wird der Wert dieses Schlüssels als Alias verwendet. Wenn der Name jedoch bereits in einer anderen angefügten Datenbank verwendet wird, schlägt die Verbindung fehl. Der Pfad kann absolut oder relativ sein, indem die DataDirectory-Ersetzungszeichenfolge verwendet wird. Wenn DataDirectory verwendet wird, muss sich die Datenbankdatei in einem Unterverzeichnis des Verzeichnisses befinden, auf das von der Ersetzungszeichenfolge verwiesen wird. Hinweis: Remoteserver-, HTTP- und UNC-Pfadnamen werden nicht unterstützt. Der Datenbankname muss mit dem Schlüsselwort (keyword) "Datenbank" (oder einem ihrer Aliase) wie folgt angegeben werden: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Ein Fehler wird generiert, wenn eine Protokolldatei im gleichen Verzeichnis wie die Datendatei enthalten ist und beim Anfügen der primären Datendatei das Schlüsselwort "database" verwendet wird. Entfernen Sie in diesem Fall die Protokolldatei. Sobald die Datenbank angefügt wird, wird automatisch auf Grundlage des physischen Pfads eine neue Protokolldatei generiert.
Authentifizierung	Nicht zutreffend	Die Authentifizierungsmethode, die für die Verbindung mit SQL-Datenbank Mithilfe der Azure Active Directory-Authentifizierung verwendet wird. Gültige Werte sind: Active Directory Integrated, Active Directory Password, Sql Password.
Spaltenverschlüsselungseinstellung	Nicht zutreffend	Aktiviert oder deaktiviert Always Encrypted Funktionalität für die Verbindung.
Verbindungstimeout - oder - Verbindungstimeout - oder - Timeout	15	Die Zeitspanne (in Sekunden), die auf eine Verbindung mit dem Server gewartet wird, bevor der Versuch beendet und ein Fehler generiert wird. Gültige Werte sind größer oder gleich 0 und kleiner oder gleich 2147483647. Wenn Sie eine Verbindung mit einer Azure SQL-Datenbank herstellen, legen Sie das Verbindungstimeout auf 30 Sekunden fest.
Verbindungslebensdauer - oder - Load Balance Timeout	0	Wenn eine Verbindung an den Pool zurückgegeben wird, wird die Erstellungszeit mit der aktuellen Zeit verglichen. Wenn diese Zeitspanne (in Sekunden) größer ist als der für die Connection Lifetime angegebene Wert, wird die Verbindung zerstört. Dies ist hilfreich bei Gruppenkonfigurationen, um einen Lastenausgleich zwischen einem bereits aktiven Server und einem Server zu erzwingen, der gerade erst online gegangen ist. Der Wert 0 (0) bewirkt, dass gepoolte Verbindungen das maximale Verbindungstimeout aufweisen.
ConnectRetryCount	1	Steuert die Anzahl der Verbindungsversuche, nachdem der Client einen Verbindungsfehler im Leerlauf identifiziert hat. Gültige Werte sind 0 bis 255. Der Standardwert ist 1. 0 bedeutet, dass nicht versucht wird, die Verbindung wiederherzustellen (Verbindungsresilienz deaktivieren). Weitere Informationen zur Verbindungsresilienz finden Sie unter .NET SqlConnection-Parameter für verbindungswiederhergestellte Wiederholungsversuche und technischen Artikel : Resilienz der Verbindung im Leerlauf.
ConnectRetryInterval	10	Gibt die Zeit zwischen jedem Verbindungswiebeleversuch (ConnectRetryCount) an. Gültige Werte sind 1 bis 60 Sekunden (Standard= 10), die nach dem ersten Verbindungsversuch angewendet werden. Wenn eine unterbrochene Verbindung erkannt wird, versucht der Client sofort, die Verbindung wiederherzustellen. Dies ist der erste Versuch, die Verbindung wiederherzustellen, und tritt nur auf, wenn ConnectRetryCount größer als 0 ist. Wenn beim ersten Verbindungsversuch ein Fehler auftritt und ConnectRetryCount größer als 1 ist, wartet der Client connectRetryInterval, um den zweiten und nachfolgenden Verbindungsversuch zu versuchen. Weitere Informationen zur Verbindungsresilienz finden Sie unter .NET SqlConnection-Parameter für verbindungswiederhergestellte Wiederholungsversuche und technischen Artikel : Resilienz der Verbindung im Leerlauf.
Kontextverbindung	"false"	true, wenn eine prozessinterne Verbindung mit SQL Server hergestellt werden soll.
Aktuelle Sprache - oder - Sprache	Nicht zutreffend	Legt die Sprache fest, die für Datenbankserverwarnungen oder Fehlermeldungen verwendet wird. Der Sprachname kann maximal 128 Zeichen lang sein.
Datenquelle - oder - Server - oder - Adresse - oder - Addr - oder - Netzwerkadresse	Nicht zutreffend	Der Name oder die Netzwerkadresse des instance des SQL Server, mit dem eine Verbindung hergestellt werden soll. Die Portnummer kann nach dem Servernamen angegeben werden: server=tcp:servername, portnumber Wenn Sie einen lokalen instance angeben, verwenden Sie immer (lokal). Um ein Protokoll zu erzwingen, fügen Sie eines der folgenden Präfixe hinzu: np:(local), tcp:(local), lpc:(local) Ab .NET Framework 4.5 können Sie auch wie folgt eine Verbindung mit einer LocalDB-Datenbank herstellen: server=(localdb)\\myInstance Weitere Informationen zu LocalDB finden Sie unter SqlClient-Unterstützung für LocalDB. Die Datenquelle muss das TCP-Format oder das Named Pipes-Format verwenden. Das TCP-Format lautet wie folgt: - tcp:<hostname>\<instance name> - tcp:<Hostname,TCP<>/IP-Portnummer> Das TCP-Format muss mit dem Präfix "tcp:" beginnen und gefolgt von der Datenbank instance, wie durch einen Hostnamen und einen instance Namen angegeben. Dieses Format gilt nicht, wenn eine Verbindung mit Azure SQL-Datenbank hergestellt wird. TCP wird automatisch für Verbindungen mit Azure SQL-Datenbank ausgewählt, wenn kein Protokoll angegeben ist. Der Hostname MUSS auf eine der folgenden Arten angegeben werden: – NetBIOSName – IPv4Address – IPv6Address Der instance Name wird verwendet, um eine bestimmte TCP/IP-Portnummer aufzulösen, auf der eine Datenbank instance gehostet wird. Alternativ ist auch die direkte Angabe einer TCP/IP-Portnummer zulässig. Wenn instance Name und Portnummer nicht vorhanden sind, wird die Standarddatenbank instance verwendet. Das Named Pipes-Format lautet wie folgt: - np:\\<hostname>\pipe\<pipe name> Das Named Pipes-Format MUSS mit dem Präfix "np:" beginnen, gefolgt von einem Named Pipe-Namen. Der Hostname MUSS auf eine der folgenden Arten angegeben werden: – NetBIOSName – IPv4Address – IPv6Address Der Pipename wird verwendet, um die Datenbank instance zu identifizieren, mit der die .NET Framework Anwendung verbunden wird. Wenn der Wert des Netzwerkschlüssels angegeben wird, sollten die Präfixe "tcp:" und "np:" nicht angegeben werden. Hinweis: Sie können die Verwendung von TCP anstelle von freigegebenem Arbeitsspeicher erzwingen, indem Sie entweder tcp: dem Servernamen im Verbindungszeichenfolge vorangestellt oder localhost verwenden.
Verschlüsseln	"false"	Wenn trueverwendet SQL Server ssl-Verschlüsselung für alle Daten, die zwischen Client und Server gesendet werden, wenn auf dem Server ein Zertifikat installiert ist. Erkannte Werte sind true, false, yes und no. Weitere Informationen finden Sie unter Verbindungszeichenfolgensyntax. Ab .NET Framework 4.5 TrustServerCertificateEncrypt muss der Servername (oder die IP-Adresse) in einem SQL Server SSL-Zertifikat genau mit dem servernamen (oder der IP-Adresse) übereinstimmen, der im Verbindungszeichenfolge angegeben ist. Andernfalls schlägt die Verbindung fehl.
Enlist	"true"	truegibt an, dass der SQL Server Verbindungspoolers die Verbindung automatisch im aktuellen Transaktionskontext des Erstellungsthreads einträgt.
Failoverpartner	Nicht zutreffend	Der Name des Failoverpartnerservers, auf dem die Datenbankspiegelung konfiguriert ist. Wenn der Wert dieses Schlüssels "" ist, muss der Anfangskatalog vorhanden sein, und sein Wert darf nicht "" sein. Der Servername kann maximal 128 Zeichen lang sein. Wenn Sie einen Failoverpartner angeben, aber der Failoverpartnerserver nicht für die Datenbankspiegelung konfiguriert ist und der primäre Server (angegeben mit dem Server-Schlüsselwort (keyword)) nicht verfügbar ist, schlägt die Verbindung fehl. Wenn Sie einen Failoverpartner angeben und der primäre Server nicht für die Datenbankspiegelung konfiguriert ist, ist die Verbindung mit dem primären Server (angegeben mit dem server-Schlüsselwort (keyword)) erfolgreich, wenn der primäre Server verfügbar ist.
Anfangskatalog - oder - Datenbank	Nicht zutreffend	Der Name der Datenbank. Der Datenbankname kann maximal 128 Zeichen lang sein.
Integrierte Sicherheit - oder - Trusted_Connection	"false"	Wenn false, Benutzer-ID und Kennwort in der Verbindung angegeben werden. Wenn true, werden die aktuellen Windows-Kontoanmeldeinformationen für die Authentifizierung verwendet. Erkannte Werte sind true, false, yes, nound sspi (dringend empfohlen), was entspricht true. Wenn Benutzer-ID und Kennwort angegeben und integrierte Sicherheit auf true festgelegt ist, werden die Benutzer-ID und das Kennwort ignoriert und integrierte Sicherheit verwendet. SqlCredentialist eine sicherere Möglichkeit, Anmeldeinformationen für eine Verbindung anzugeben, die SQL Server-Authentifizierung (Integrated Security=false) verwendet.
Max Pool Size	100	Die maximale Anzahl von Verbindungen, die im Pool zulässig sind. Gültige Werte sind größer als oder gleich 1. Werte, die kleiner als die Mindestpoolgröße sind, generieren einen Fehler.
Min Pool Size	0	Die Mindestanzahl von Verbindungen, die im Pool zulässig sind. Gültige Werte sind größer oder gleich 0. Null (0) in diesem Feld bedeutet, dass zunächst keine Mindestverbindungen geöffnet werden. Werte, die größer als die maximale Poolgröße sind, generieren einen Fehler.
MultipleActiveResultSets	"false"	Wenn true, kann eine Anwendung mehrere aktive Resultsets (MARS) verwalten. Wenn false, muss eine Anwendung alle Resultsets aus einem Batch verarbeiten oder abbrechen, bevor sie einen anderen Batch für diese Verbindung ausführen kann. Gültige Werte sind true und false. Weitere Informationen finden Sie unter Multiple Active Result Sets (MARS).
MultiSubnetFailover	false	Geben Sie immer anmultiSubnetFailover=True, wenn Sie eine Verbindung mit dem Verfügbarkeitsgruppenlistener einer SQL Server 2012 (oder höher) Verfügbarkeitsgruppe oder einer SQL Server 2012 (oder höher) Failoverclusterinstanz herstellen. multiSubnetFailover=True konfiguriert SqlClient, um eine schnellere Erkennung und Verbindung mit dem (derzeit) aktiven Server zu ermöglichen. Mögliche Werte sind Yes und No, True und False oder 1 und und 0. Beispiel: MultiSubnetFailover=True Der Standardwert ist False. Weitere Informationen zur Unterstützung von SqlClient für Always On AGs finden Sie unter SqlClient-Unterstützung für Hochverfügbarkeit, Notfallwiederherstellung.
Network Library - oder - Netzwerk - oder - Net	Nicht zutreffend	Die Netzwerkbibliothek, die zum Herstellen einer Verbindung mit einer instance von SQL Server verwendet wird. Unterstützte Werte sind: dbnmpntw (Named Pipes) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (Shared Memory) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) Die entsprechende Netzwerk-DLL muss auf dem System installiert werden, mit dem Sie eine Verbindung herstellen. Wenn Sie kein Netzwerk angeben und einen lokalen Server verwenden (z. B. "." oder "(local)"), wird gemeinsam genutzter Arbeitsspeicher verwendet. In diesem Beispiel handelt es sich um die Netzwerkbibliothek Win32 Winsock TCP/IP (dbmssocn), wobei der Port 1433 verwendet wird. Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet Size	8.000	Größe der Netzwerkpakete, die für die Kommunikation mit einer instance von SQL Server verwendet werden, in Bytes. Die Paketgröße kann größer oder gleich 512 und kleiner als oder gleich 32768 sein.
Kennwort - oder - PWD	Nicht zutreffend	Das Kennwort für das SQL Server Konto, das sich anmeldet. Nicht empfohlen. Um ein hohes Maß an Sicherheit zu gewährleisten, wird dringend empfohlen, stattdessen die Integrated SecurityTrusted_Connection oder Schlüsselwort (keyword) zu verwenden. SqlCredentialist eine sicherere Möglichkeit, Anmeldeinformationen für eine Verbindung anzugeben, die SQL Server-Authentifizierung verwendet. Das Kennwort muss maximal 128 Zeichen lang sein.
Sicherheitsinformationen permanent speichern - oder - PersistSecurityInfo	"false"	Bei Festlegung auf false oder no (dringend empfohlen) werden sicherheitsrelevante Informationen, z. B. das Kennwort, nicht als Teil der Verbindung zurückgegeben, wenn die Verbindung geöffnet ist oder sich jemals in einem geöffneten Zustand befunden hat. Beim Zurücksetzen des Verbindungszeichenfolge werden alle Verbindungszeichenfolge Werte zurückgesetzt, einschließlich des Kennworts. Erkannte Werte sind true, false, yes und no.
PoolBlockingPeriod	Automatisch	Legt das Blockierzeitverhalten für einen Verbindungspool fest. Weitere Informationen finden Sie in der Eigenschaft PoolBlockingPeriod.
Pooling	"true"	Wenn der Wert dieses Schlüssels auf true festgelegt ist, wird jede neu erstellte Verbindung dem Pool hinzugefügt, wenn sie von der Anwendung geschlossen wird. Beim nächsten Versuch, dieselbe Verbindung zu öffnen, wird diese Verbindung aus dem Pool gezogen. Connections gelten als identisch, wenn sie über die gleichen Verbindungszeichenfolge verfügen. Verschiedene Verbindungen weisen unterschiedliche Verbindungszeichenfolgen auf. Der Wert dieses Schlüssels kann "true", "false", "yes" oder "no" sein.
Replikation	"false"	true , wenn die Replikation über die Verbindung unterstützt wird.
Transaktion Binding	Implicit Unbind	Steuert die Verbindungszuordnung mit einer eingetragenen System.Transactions Transaktion. Mögliche Werte: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Implizites Aufheben der Bindung bewirkt, dass die Verbindung von der Transaktion getrennt wird, wenn sie endet. Nach der Trennung werden im Autocommit-Modus zusätzliche Anforderungen für die Verbindung ausgeführt. Die System.Transactions.Transaction.Current-Eigenschaft wird nicht überprüft, wenn Anforderungen ausgeführt werden, solange die Transaktion aktiv ist. Nach Ende der Transaktion werden im Autocommit-Modus zusätzliche Anforderungen ausgeführt. Wenn das System die Transaktion (im Bereich eines using-Blocks) beendet, bevor der letzte Befehl abgeschlossen ist, wird ausgelöst InvalidOperationException. Explizites Aufheben der Bindung bewirkt, dass die Verbindung an die Transaktion angefügt bleibt, bis die Verbindung geschlossen oder eine explizite SqlConnection.TransactionEnlist(null) aufgerufen wird. Ab .NET Framework 4 machen Änderungen an impliziter Bindungsbindung die explizite Bindungsbindung überflüssig. Eine InvalidOperationException wird ausgelöst, wenn es sich bei Transaction.Current nicht um die eingetragene Transaktion handelt, oder wenn die eingetragene Transaktion nicht aktiv ist.
TransparentNetworkIPResolution	Siehe Beschreibung.	Wenn der Wert dieses Schlüssels auf true festgelegt wird, muss die Anwendung alle IP-Adressen für einen bestimmten DNS-Eintrag abrufen und versuchen, mit der ersten Adresse auf der Liste eine Verbindung herzustellen. Wenn die Verbindung nicht innerhalb von 0,5 Sekunden hergestellt wird, versucht die Verbindung, parallel mit allen anderen Adressen eine Verbindung herzustellen. Wenn die erste Adresse antwortet, stellt die Anwendung eine Verbindung mit der antwortenden IP-Adresse her. Wenn der MultiSubnetFailover Schlüssel auf truefestgelegt ist, TransparentNetworkIPResolution wird ignoriert. Wenn der Failover Partner Schlüssel festgelegt ist, TransparentNetworkIPResolution wird ignoriert. Der Wert dieses Schlüssels muss , false, yesoder noseintrue. Ein Wert von yes wird genauso behandelt wie ein Wert von true. Ein Wert von no wird genauso behandelt wie ein Wert von false. Die Standardwerte sind wie folgt: false Wenn: Herstellen einer Verbindung mit Azure SQL Datenbank, bei der die Datenquelle mit folgendem Ende endet: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net Authentication ist "Active Directory Password" oder "Active Directory Integrated" true in allen anderen Fällen.
TrustServerCertificate	"false"	Bei Festlegung auf truewird SSL verwendet, um den Kanal zu verschlüsseln, wenn das Durchlaufen der Zertifikatkette zum Überprüfen der Vertrauensstellung umgangen wird. Wenn TrustServerCertificate auf true und Encrypt auf falsefestgelegt ist, wird der Kanal nicht verschlüsselt. Erkannte Werte sind true, false, yes und no. Weitere Informationen finden Sie unter Verbindungszeichenfolgensyntax.
Typsystemversion	Nicht zutreffend	Ein Zeichenfolgenwert, der das von der Anwendung erwartete Typsystem angibt. Welche Funktionalität einer Clientanwendung zur Verfügung steht, hängt von der SQL Server-Version und der Kompatibilitätsstufe der Datenbank ab. Durch die explizite Festlegung der Systemversion, für die die Clientanwendung geschrieben wurde, werden potenzielle Probleme vermieden, die dazu führen könnten, dass eine Anwendung nicht funktioniert, wenn eine andere SQL Server-Version verwendet wird. Hinweis: Die Typsystemversion kann nicht für CLR-Code (Common Language Runtime) festgelegt werden, der prozessintern in SQL Server ausgeführt wird. Weitere Informationen finden Sie unter SQL Server Common Language Runtime-Integration. Mögliche Werte: Type System Version=SQL Server 2012; Type System Version=SQL Server 2008; Type System Version=SQL Server 2005; Type System Version=Latest; Type System Version=SQL Server 2012; gibt an, dass die Anwendung Version 11.0.0.0 von Microsoft.SqlServer.Types.dll erfordert. Für die anderen Type System Version Einstellungen ist version 10.0.0.0 von Microsoft.SqlServer.Types.dll erforderlich. Latest ist veraltet und sollte nicht verwendet werden. Latest entspricht Type System Version=SQL Server 2008;.
Benutzer-ID - oder - UID - oder - Benutzer	Nicht zutreffend	Das SQL Server Anmeldekonto. Nicht empfohlen. Um ein hohes Maß an Sicherheit zu gewährleisten, wird dringend empfohlen, stattdessen die Integrated Security Schlüsselwörter oder zu Trusted_Connection verwenden. SqlCredentialist eine sicherere Möglichkeit zum Angeben von Anmeldeinformationen für eine Verbindung, die SQL Server-Authentifizierung verwendet. Die Benutzer-ID muss maximal 128 Zeichen lang sein.
User Instance	"false"	Ein -Wert, der angibt, ob die Verbindung vom Standard-SQL Server Express instance zu einer laufzeitinitiierte instance umgeleitet werden soll, die unter dem Konto des Aufrufers ausgeführt wird.
Workstation ID - oder - WSID	Name des lokalen Computers	Der Name der Arbeitsstation, die eine Verbindung mit SQL Server. Die ID muss maximal 128 Zeichen lang sein.

Die folgende Liste enthält die gültigen Namen für Verbindungspoolingwerte innerhalb von ConnectionString. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).

• Verbindungslebensdauer (oder Lastenausgleichstimeout)

• Enlist

• Max Pool Size

• Min Pool Size

• Pooling

Wenn Sie Schlüsselwort (keyword)- oder Verbindungspoolingwerte festlegen, die einen booleschen Wert erfordern, können Sie "ja" anstelle von "true" und "nein" anstelle von "false" verwenden. Ganzzahlige Werte werden als Zeichenfolgen dargestellt.

Hinweis

Der .NET Framework-Datenanbieter für SQL Server verwendet sein eigenes Protokoll für die Kommunikation mit SQL Server. Daher wird die Verwendung eines ODBC-Datenquellennamens (DSN) beim Herstellen einer Verbindung mit SQL Server nicht unterstützt, da keine ODBC-Ebene hinzugefügt wird.

Hinweis

UDL-Dateien (Universal Data Link) werden für den .NET Framework-Datenanbieter für SQL Server nicht unterstützt.

Achtung

In dieser Version sollte die Anwendung beim Erstellen eines Verbindungszeichenfolge auf Der Grundlage von Benutzereingaben (z. B. beim Abrufen von Benutzer-ID- und Kennwortinformationen aus einem Dialogfeld und beim Anfügen an die Verbindungszeichenfolge) vorsichtshalber vorgehen. Die Anwendung sollte sicherstellen, dass ein Benutzer keine zusätzlichen Verbindungszeichenfolge Parameter in diese Werte einbetten kann (z. B. Eingabe eines Kennworts als "validpassword; database=somedb" beim Versuch, an eine andere Datenbank anzufügen. Wenn Sie Verbindungszeichenfolgen basierend auf Benutzereingaben erstellen müssen, verwenden Sie die neue SqlConnectionStringBuilder, die die Verbindungszeichenfolge überprüft und hilft, dieses Problem zu beseitigen. Weitere Informationen finden Sie unter Verbindungszeichenfolgen-Generatoren .

Weitere Informationen

• ADO.NET Managed Provider und DataSet Developer Center
• Verbindungszeichenfolgen in ADO.NET
• SQL Server-Verbindungspooling (ADO.NET)
• Verbinden mit einer Datenquelle in ADO.NET
• Übersicht über ADO.NET