SqlConnection.ConnectionString Eigenschaft

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Dient zum Abrufen oder Festlegen der Zeichenfolge, die zum Öffnen einer SQL Server-Datenbank verwendet wird.

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

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Eigenschaftswert

String

Die Verbindungszeichenfolge, die den Quelldatenbanknamen und andere Parameter enthält, die zum Herstellen der anfänglichen Verbindung erforderlich sind. Der Standardwert ist eine leere Zeichenfolge.

Attribute

SettingsBindableAttribute

Ausnahmen

ArgumentException

Es wurde ein ungültiges Verbindungszeichenfolgenargument angegeben, oder es wurde kein erforderliches Verbindungszeichenfolgenargument angegeben.

Beispiele

Im folgenden Beispiel wird vor dem Öffnen der ConnectionString Verbindung eine SqlConnection Eigenschaft erstellt und festgelegt.

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

Dies ConnectionString ähnelt einer OLE DB-Verbindungszeichenfolge, ist jedoch nicht identisch. Im Gegensatz zu OLE DB oder ADO ist die zurückgegebene Verbindungszeichenfolge identisch mit dem vom Benutzer festgelegten ConnectionStringSicherheitsinformationen abzüglich sicherheitsrelevanter Informationen, wenn der Wert "Persist Security Info" auf false (Standardeinstellung) 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 true.

Sie können die ConnectionString Eigenschaft verwenden, um eine Verbindung mit einer Datenbank herzustellen. Im folgenden Beispiel wird eine typische Verbindungszeichenfolge veranschaulicht.

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

Verwenden Sie die 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 Verbindungszeichenfolgenwerte weisen entsprechende schreibgeschützte Eigenschaften auf. Wenn die Verbindungszeichenfolge festgelegt ist, werden diese Eigenschaften aktualisiert, außer wenn ein Fehler erkannt wird. In diesem Fall werden keine der Eigenschaften aktualisiert. SqlConnection Eigenschaften geben nur die Einstellungen zurück, die in der ConnectionString.

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

Durch das Zurücksetzen einer ConnectionString geschlossenen Verbindung werden alle Verbindungszeichenfolgenwerte (und verwandte Eigenschaften) einschließlich des Kennworts zurückgesetzt. Wenn Sie beispielsweise eine Verbindungszeichenfolge festlegen, die "Database= AdventureWorks" enthält, und setzen Sie dann die Verbindungszeichenfolge auf "Data Source=myserver" zurück. Integrated Security=true", die Database Eigenschaft ist nicht mehr auf "AdventureWorks" festgelegt.

Die Verbindungszeichenfolge wird unmittelbar nach dem Festlegen analysiert. Wenn Fehler in der Syntax beim Analysieren gefunden werden, wird eine Laufzeitausnahme wie z ArgumentException. B. generiert. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das grundlegende Format einer Verbindungszeichenfolge enthält eine Reihe von Schlüsselwort-Wert-Paaren, die durch Semikolons getrennt sind. Das Gleichheitszeichen (=) verbindet jedes Schlüsselwort und seinen 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 Doppeltes 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 doppelten Anführungszeichen beginnt. Umgekehrt kann das doppelte Anführungszeichen verwendet werden, wenn der Wert mit einem einfachen Anführungszeichen beginnt. Wenn der Wert sowohl ein anführungszeichen als auch doppeltes Anführungszeichen enthält, muss das Zum Einschließen des Werts verwendete Anführungszeichen 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 nachgestellten Leerzeichen um ganze Zahl, boolesche oder aufgezählte Werte werden ignoriert, auch wenn sie in Anführungszeichen eingeschlossen sind. Leerzeichen innerhalb eines Zeichenfolgenliteralschlüsselworts oder -werts bleiben jedoch erhalten. Einfache oder doppelte Anführungszeichen können innerhalb einer Verbindungszeichenfolge verwendet werden, ohne Trennzeichen zu verwenden (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üsselwortwerte in der ConnectionStringTabelle aufgeführt.

Keyword	Vorgabe	Beschreibung
Addr	N/A	Synonym für Datenquelle.
Address	N/A	Synonym für Datenquelle.
App	N/A	Synonym für Anwendungsname.
Application Name	N/A	Der Name der Anwendung oder des .NET SQLClient-Datenanbieters, 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 Always On-Verfügbarkeitsgruppen finden Sie unter SqlClient-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.
Asynchronous Processing - oder - Async	'false'	Wenn true, aktiviert asynchrone Vorgangsunterstützung. 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 - Initial File Name	N/A	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 in der Verbindungszeichenfolge angegeben wird, wird die Datenbank angefügt und 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 AttachDBFileName-Schlüssel 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 die Datenbankdatei in einem Unterverzeichnis des Verzeichnisses vorhanden sein, auf das durch die Ersetzungszeichenfolge verwiesen wird. Hinweis: Remoteserver-, HTTP- und UNC-Pfadnamen werden nicht unterstützt. Der Datenbankname muss wie folgt mit dem Schlüsselwort 'database' (oder einem seiner Aliase) angegeben werden: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Ein Fehler wird generiert, wenn eine Protokolldatei im selben Verzeichnis wie die Datendatei vorhanden ist und das Schlüsselwort "database" beim Anfügen der primären Datendatei verwendet wird. Entfernen Sie in diesem Fall die Protokolldatei. Sobald die Datenbank angefügt ist, wird basierend auf dem physischen Pfad automatisch eine neue Protokolldatei generiert.
Authentication	N/A	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.
Column Encryption Setting	N/A	Aktiviert oder deaktiviert die Always Encrypted-Funktion für die Verbindung.
Connect Timeout - oder - Connection Timeout - oder - Timeout	15	Die Zeitdauer (in Sekunden), die auf eine Verbindung mit dem Server wartet, bevor der Versuch beendet und ein Fehler generiert wird. Gültige Werte sind größer oder gleich 0 und kleiner als oder gleich 2147483647. Legen Sie beim Öffnen einer Verbindung mit einer Azure SQL-Datenbank das Verbindungstimeout auf 30 Sekunden fest.
Connection Lifetime - 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. Ein Wert von Null (0) bewirkt, dass poolierte Verbindungen das maximale Verbindungstimeout aufweisen.
ConnectRetryCount	1	Steuert die Anzahl der Wiederholungsversuche, nachdem der Client einen Fehler bei der Leerlaufverbindung 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 verbindungs retry und Technical Article – Idle Connection Resiliency.
ConnectRetryInterval	10	Gibt die Zeit zwischen jedem Verbindungsversuch (ConnectRetryCount) an. Gültige Werte sind 1 bis 60 Sekunden (Default=10), die nach dem ersten erneuten Verbindungsversuch angewendet werden. Wenn eine fehlerhafte Verbindung erkannt wird, versucht der Client sofort, eine erneute Verbindung herzustellen. Dies ist der erste Erneutverbindungsversuch und tritt nur auf, wenn ConnectRetryCount größer als 0 ist. Wenn der erste Erneutverbindungsversuch fehlschlägt und ConnectRetryCount größer als 1 ist, wartet der Client connectRetryInterval, um den zweiten und nachfolgenden erneuten Verbindungsversuch zu versuchen. Weitere Informationen zur Verbindungsresilienz finden Sie unter .NET SqlConnection-Parameter für verbindungs retry und Technical Article – Idle Connection Resiliency.
Context Connection	'false'	true wenn eine in-Process-Verbindung mit SQL Server hergestellt werden soll.
Current Language - oder - Language	N/A	Legt die Sprache fest, die für Datenbankserverwarnungen oder Fehlermeldungen verwendet wird. Der Sprachname kann maximal 128 Zeichen lang sein.
Data Source - oder - Server - oder - Address - oder - Addr - oder - Network Address	N/A	Der Name oder die Netzwerkadresse der Instanz von SQL Server, mit der eine Verbindung hergestellt werden soll. Die Portnummer kann nach dem Servernamen angegeben werden: server=tcp:servername, portnumber Wenn Sie eine lokale Instanz 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 eine Verbindung mit einer LocalDB-Datenbank wie folgt 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 folgt der Datenbankinstanz, wie durch einen Hostnamen und einen Instanznamen angegeben. Dieses Format ist beim Herstellen einer Verbindung mit der Azure SQL-Datenbank nicht anwendbar. TCP wird automatisch für Verbindungen mit azure SQL-Datenbank ausgewählt, wenn kein Protokoll angegeben wird. Der Hostname MUSS auf eine der folgenden Arten angegeben werden: - NetBIOSName - IPv4Address - IPv6Address Der Instanzname wird verwendet, um eine bestimmte TCP/IP-Portnummer aufzulösen, auf der eine Datenbankinstanz gehostet wird. Alternativ ist auch die direkte Angabe einer TCP/IP-Portnummer zulässig. Wenn sowohl der Instanzname als auch die Portnummer nicht vorhanden sind, wird die Standarddatenbankinstanz verwendet. Das Named Pipes-Format lautet wie folgt: - np:\\<Hostname>\pipe\<pipe name> Das Named Pipes-Format MUSS mit dem Präfix "np:" beginnen und folgt einem benannten Pipenamen. Der Hostname MUSS auf eine der folgenden Arten angegeben werden: - NetBIOSName - IPv4Address - IPv6Address Der Pipename wird verwendet, um die Datenbankinstanz zu identifizieren, mit der die .NET Framework-Anwendung verbunden wird. Wenn der Wert des Netzwerkschlüssels angegeben ist, sollten die Präfixe "tcp:" und "np:" nicht angegeben werden. Hinweis: Sie können die Verwendung von TCP anstelle des freigegebenen Speichers erzwingen, indem Sie tcp voranstellen: dem Servernamen in der Verbindungszeichenfolge oder mithilfe von localhost.
Encrypt	'false'	Wenn trueSQL Server SSL-Verschlüsselung für alle Daten verwendet, die zwischen dem Client und dem 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 muss der TrustServerCertificateEncrypt Servername (oder die IP-Adresse) in einem SQL Server-SSL-Zertifikat exakt mit dem Servernamen (oder der IP-Adresse) übereinstimmen, der in der Verbindungszeichenfolge angegeben ist. Andernfalls schlägt der Verbindungsversuch fehl.
Enlist	'true'	true gibt an, dass der SQL Server-Verbindungspooler die Verbindung automatisch im aktuellen Transaktionskontext des Erstellungsthreads auflistet.
Failover Partner	N/A	Der Name des Failoverpartnerservers, auf dem die Datenbankspiegelung konfiguriert ist. Wenn der Wert dieses Schlüssels "" lautet, muss der Ursprüngliche Katalog vorhanden sein, und sein Wert darf nicht "" sein. Der Servername kann maximal 128 Zeichen lang sein. Wenn Sie einen Failoverpartner angeben, der Failoverpartnerserver jedoch nicht für die Datenbankspiegelung konfiguriert ist und der primäre Server (mit dem Schlüsselwort Server angegeben) 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, wird die Verbindung mit dem primären Server (angegeben mit dem Schlüsselwort Server) erfolgreich ausgeführt, wenn der primäre Server verfügbar ist.
Initial Catalog - oder - Database	N/A	Der Name der Datenbank. Der Datenbankname kann maximal 128 Zeichen lang sein.
Integrated Security - oder - Trusted_Connection	'false'	Wenn false, Benutzer-ID und Kennwort werden in der Verbindung angegeben. Wenn truedie aktuellen Windows-Kontoanmeldeinformationen für die Authentifizierung verwendet werden. Erkannte Werte sind true, false, , yes, nound sspi (dringend empfohlen), die entspricht true. Wenn Die Benutzer-ID und das Kennwort angegeben sind und die integrierte Sicherheit auf "true" festgelegt ist, wird die Benutzer-ID und das Kennwort ignoriert, und die integrierte Sicherheit wird verwendet. SqlCredential ist 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 oder gleich 1. Werte, die kleiner als min. Poolgröß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 anfänglich keine Mindestverbindungen geöffnet werden. Werte, die größer als max. 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	FALSCH	Geben Sie immer an multiSubnetFailover=True , wenn Sie eine Verbindung mit dem Verfügbarkeitsgruppenlistener einer SQL Server 2012 -Verfügbarkeitsgruppe (oder höher) oder einer SQL Server 2012 -Failoverclusterinstanz (oder höher) 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 , TrueNound oder 1False und .0 Beispiel: MultiSubnetFailover=True Der Standardwert lautet False. Weitere Informationen zur Unterstützung von Always On AGs von SqlClient finden Sie unter SqlClient-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.
Network Library - oder - Network - oder - Net	N/A	Die Netzwerkbibliothek, die zum Herstellen einer Verbindung mit einer Instanz 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 sein, mit dem Sie eine Verbindung herstellen. Wenn Sie kein Netzwerk angeben und einen lokalen Server (z. B. "." oder "(lokal)") verwenden, wird freigegebener Speicher verwendet. In diesem Beispiel ist die Netzwerkbibliothek Win32 Winsock TCP/IP (dbmssocn), und 1433 ist der verwendete Port. Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet Size	8.000	Größe in Byte der Netzwerkpakete, die für die Kommunikation mit einer Instanz von SQL Server verwendet werden. Die Paketgröße kann größer oder gleich 512 und kleiner oder gleich 32768 sein.
Password - oder - PWD	N/A	Das Kennwort für die SQL Server-Kontoanmeldung. Nicht empfohlen. Um ein hohes Maß an Sicherheit aufrechtzuerhalten, empfehlen wir dringend, stattdessen das Schlüsselwort oder Trusted_Connection das Integrated Security Schlüsselwort zu verwenden. SqlCredential ist eine sicherere Möglichkeit, Anmeldeinformationen für eine Verbindung anzugeben, die DIE SQL Server-Authentifizierung verwendet. Das Kennwort muss maximal 128 Zeichen lang sein.
Persist Security Info - oder - PersistSecurityInfo	'false'	Wenn diese Einstellung auf false oder no (dringend empfohlen) festgelegt ist, 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 befindet. Durch das Zurücksetzen der Verbindungszeichenfolge werden alle Verbindungszeichenfolgenwerte einschließlich des Kennworts zurückgesetzt. Erkannte Werte sind true, false, yes und no.
PoolBlockingPeriod	Auto	Legt das Blockierungszeitraumsverhalten für einen Verbindungspool fest. Details finden Sie PoolBlockingPeriod in der Eigenschaft.
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. Bei einem nächsten Versuch, dieselbe Verbindung zu öffnen, wird diese Verbindung aus dem Pool gezeichnet. Verbindungen werden als identisch betrachtet, wenn sie über dieselbe Verbindungszeichenfolge verfügen. Unterschiedliche Verbindungen weisen unterschiedliche Verbindungszeichenfolgen auf. Der Wert dieses Schlüssels kann "true", "false", "yes" oder "no" sein.
Replication	'false'	true wenn die Replikation mithilfe der Verbindung unterstützt wird.
Transaction Binding	Implizites Lösen	Steuert die Verbindungszuordnung mit einer aufgelisteten System.Transactions Transaktion. Mögliche Werte: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Implizites Unbind bewirkt, dass die Verbindung von der Transaktion getrennt wird, wenn sie endet. Nach dem Trennen werden zusätzliche Anforderungen für die Verbindung im Autocommit-Modus ausgeführt. Die System.Transactions.Transaction.Current Eigenschaft wird nicht überprüft, wenn Anforderungen ausgeführt werden, während die Transaktion aktiv ist. Nachdem die Transaktion beendet wurde, werden zusätzliche Anforderungen im AutoCommit-Modus ausgeführt. Wenn das System die Transaktion (im Bereich eines Using-Blocks) beendet, bevor der letzte Befehl abgeschlossen ist, wird sie ausgelöst InvalidOperationException. Die explizite Bindung bewirkt, dass die Verbindung mit der Transaktion verbunden bleibt, bis die Verbindung geschlossen oder explizit SqlConnection.TransactionEnlist(null) aufgerufen wird. Ab .NET Framework 4 werden Änderungen an impliziten Unbind-Änderungen veraltet. Ein InvalidOperationException Fehler wird ausgelöst, wenn Transaction.Current es sich nicht um die aufgelistete Transaktion handelt oder wenn die aufgelistete Transaktion nicht aktiv ist.
TransparentNetworkIPResolution	Siehe Beschreibung.	Wenn der Wert dieses Schlüssels auf festgelegt trueist, muss die Anwendung alle IP-Adressen für einen bestimmten DNS-Eintrag abrufen und versuchen, eine Verbindung mit dem ersten in der Liste herzustellen. Wenn die Verbindung nicht innerhalb von 0,5 Sekunden hergestellt wird, versucht die Anwendung, parallel eine Verbindung mit allen anderen herzustellen. Wenn die ersten Antworten beantwortet werden, stellt die Anwendung die Verbindung mit der ip-Adresse des Befragten her. Wenn der MultiSubnetFailover Schlüssel auf true" TransparentNetworkIPResolution , wird ignoriert. Wenn der Failover Partner Schlüssel festgelegt ist, TransparentNetworkIPResolution wird er ignoriert. Der Wert dieses Schlüssels muss , true, false, yesoder no. 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 der Azure SQL-Datenbank, bei der die Datenquelle endet mit: .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 true" wird SSL verwendet, um den Kanal zu verschlüsseln, wenn die Zertifikatkette umgangen wird, um die Vertrauensstellung zu überprüfen. Wenn TrustServerCertificate auf true "Verschlüsseln" festgelegt ist, wird falseder Kanal nicht verschlüsselt. Erkannte Werte sind true, false, yes und no. Weitere Informationen finden Sie unter Verbindungszeichenfolgensyntax.
Type System Version	N/A	Ein Zeichenfolgenwert, der das Typsystem angibt, das die Anwendung erwartet. Die für eine Clientanwendung verfügbare Funktionalität hängt von der Version von SQL Server und der Kompatibilitätsebene der Datenbank ab. Durch das explizite Festlegen der Typsystemversion, die die Clientanwendung geschrieben wurde, werden potenzielle Probleme vermieden, die dazu führen können, dass eine Anwendung nicht mehr funktioniert, wenn eine andere Version von SQL Server verwendet wird. Hinweis: Die Typsystemversion kann nicht für CLR-Code (Common Language Runtime) festgelegt werden, der 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 für die Anwendung Version 11.0.0.0 von Microsoft.SqlServer.Types.dllerforderlich ist. Für die anderen Type System Version Einstellungen ist Version 10.0.0.0 von Microsoft.SqlServer.Types.dllerforderlich. Latest ist veraltet und sollte nicht verwendet werden. Latest entspricht Type System Version=SQL Server 2008;.
User ID - oder - UID - oder - User	N/A	Das SQL Server-Anmeldekonto. Nicht empfohlen. Um ein hohes Maß an Sicherheit aufrechtzuerhalten, empfehlen wir dringend, stattdessen die Integrated Security Schlüsselwörter zu Trusted_Connection verwenden. SqlCredential ist eine sicherere Möglichkeit, Anmeldeinformationen für eine Verbindung anzugeben, die DIE SQL Server-Authentifizierung verwendet. Die Benutzer-ID muss maximal 128 Zeichen lang sein.
User Instance	'false'	Ein Wert, der angibt, ob die Verbindung von der standardmäßigen SQL Server Express-Instanz an eine laufzeitinitiierte Instanz umgeleitet werden soll, die unter dem Konto des Aufrufers ausgeführt wird.
Workstation ID - oder - WSID	Der Name des lokalen Computers	Der Name der Arbeitsstation, die eine Verbindung mit SQL Server herstellt. Die ID muss maximal 128 Zeichen lang sein.

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

• Connection Lifetime (oder Load Balance Timeout)
• Enlist
• Max Pool Size
• Min Pool Size
• Pooling

Wenn Sie Schlüsselwort- oder Verbindungspoolwerte festlegen, die einen booleschen Wert erfordern, können yes Sie anstelle von trueund no anstelle von false. Ganze Zahlen werden als Zeichenfolgen dargestellt.

Hinweis

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

Hinweis

UDL-Dateien (Universelle Datenverbindung) werden für den .NET Framework-Datenanbieter für SQL Server nicht unterstützt.

Vorsicht

Achten Sie beim Erstellen einer Verbindungszeichenfolge auf der Grundlage der Benutzereingabe (z. B. beim Abrufen von Benutzer-ID- und Kennwortinformationen aus einem Dialogfeld und beim Anfügen an die Verbindungszeichenfolge). Stellen Sie sicher, dass ein Benutzer keine zusätzlichen Verbindungszeichenfolgenparameter in diese Werte einbetten kann (z. B. das Eingeben eines Kennworts als "validpassword; database=somedb" in einem Versuch, an eine andere Datenbank anzufügen). Wenn Sie Verbindungszeichenfolgen basierend auf der Benutzereingabe erstellen müssen, verwenden Sie diese, SqlConnectionStringBuilderdie die Verbindungszeichenfolge überprüft und hilft, dieses Problem zu beheben. Weitere Informationen finden Sie in Connection String Builders (Verbindungszeichenfolgengeneratoren).

Weitere Informationen

• ADO.NET verwaltete Anbieter und DataSet Developer Center
• Verbindungszeichenfolgen in ADO.NET
• SQL Server-Verbindungspooling (ADO.NET)
• Herstellen einer Verbindung mit einer Datenquelle in ADO.NET
• Übersicht über ADO.NET