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

SqlConnection-Klasse

 

Veröffentlicht: August 2016

Stellt eine offene Verbindung mit einer SQL Server-Datenbank dar. Diese Klasse kann nicht vererbt werden.

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.SqlClient.SqlConnection

public sealed class SqlConnection : DbConnection, ICloneable

NameBeschreibung
System_CAPS_pubmethodSqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.

System_CAPS_pubmethodSqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.

System_CAPS_pubmethodSqlConnection(String, SqlCredential)

Initialisiert eine neue Instanz der SqlConnection-Klasse mit einer Verbindungszeichenfolge, die weder Integrated Security = true noch ein SqlCredential-Objekt verwendet, das die Benutzer-ID und das Kennwort enthält.

NameBeschreibung
System_CAPS_pubpropertyAccessToken

Ruft das Zugriffstoken für die Verbindung ab oder legt es fest.

System_CAPS_pubpropertyClientConnectionId

Die Verbindungs-ID der letzten Verbindungsversuchs, unabhängig davon, ob der Versuch erfolgreich war oder fehlgeschlagen ist.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionKeyCacheTtl

Ruft ab oder legt ihn fest der Time-to-live für die spaltenverschlüsselung Schlüsseleinträge in den Cache des Verschlüsselung Spalte für die Always Encrypted Funktion. Der Standardwert ist 2 Stunden. 0 bedeutet, dass keine Zwischenspeicherung stattfindet.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionQueryMetadataCacheEnabled

Ruft ab oder legt einen Wert, der angibt, ob das Zwischenspeichern von Metadaten aktiviert ist (true) oder nicht (false) für parametrisierte Abfragen für Always Encrypted -fähige Datenbanken. Der Standardwert ist true.

System_CAPS_pubpropertySystem_CAPS_staticColumnEncryptionTrustedMasterKeyPaths

Ermöglicht es Ihnen, eine Liste von vertrauenswürdigen Schlüsselpfaden für einen Datenbankserver festzulegen. Wenn der Treiber während der Verarbeitung einer Anwendungsabfrage einen Schlüsselpfad empfängt, der nicht in der Liste enthalten ist, schlägt die Abfrage fehl. Diese Eigenschaft bietet zusätzlichen Schutz vor Sicherheitsangriffen, bei denen ein gefährdeter SQL Server falsche Schlüsselpfade bereitstellt, was zur Offenlegung von Schlüsselspeicher-Anmeldeinformationen führen kann.

System_CAPS_pubpropertyConnectionString

Ruft die Zeichenfolge ab, mit der eine SQL Server-Datenbank geöffnet wird, oder legt diese fest.(Überschreibt DbConnection.ConnectionString.)

System_CAPS_pubpropertyConnectionTimeout

Ruft die Zeit ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird.(Überschreibt DbConnection.ConnectionTimeout.)

System_CAPS_pubpropertyContainer

Ruft die IContainer enthält die Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyCredential

Ruft das SqlCredential-Objekt für diese Verbindung ab, oder legt es fest.

System_CAPS_pubpropertyDatabase

Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung zu verwendenden Datenbank ab.(Überschreibt DbConnection.Database.)

System_CAPS_pubpropertyDataSource

Ruft den Namen der SQL Server-Instanz ab, mit der eine Verbindung hergestellt werden soll.(Überschreibt DbConnection.DataSource.)

System_CAPS_pubpropertyFireInfoMessageEventOnUserErrors

Ruft die FireInfoMessageEventOnUserErrors-Eigenschaft ab oder legt diese fest.

System_CAPS_pubpropertyPacketSize

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

System_CAPS_pubpropertyServerVersion

Ruft eine Zeichenfolge mit der Version der SQL Server-Instanz ab, mit der der Client verbunden ist.(Überschreibt DbConnection.ServerVersion.)

System_CAPS_pubpropertySite

Ruft ab oder legt die ISite von der Component.(Geerbt von „Component“.)

System_CAPS_pubpropertyState

Gibt den Zustand von SqlConnection während des letzten Netzwerkvorgangs an, der für die Verbindung ausgeführt wurde.(Überschreibt DbConnection.State.)

System_CAPS_pubpropertyStatisticsEnabled

Wenn true, wird für die aktuelle Verbindung die Statistikdatenerhebung aktiviert.

System_CAPS_pubpropertyWorkstationId

Ruft eine Zeichenfolge ab, die den Datenbankclient bezeichnet.

NameBeschreibung
System_CAPS_pubmethodBeginTransaction()

Startet eine Datenbanktransaktion.

System_CAPS_pubmethodBeginTransaction(IsolationLevel)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad.

System_CAPS_pubmethodBeginTransaction(IsolationLevel, String)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad und Transaktionsnamen.

System_CAPS_pubmethodBeginTransaction(String)

Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen.

System_CAPS_pubmethodChangeDatabase(String)

Ändert die aktuelle Datenbank für eine offene SqlConnection.(Überschreibt DbConnection.ChangeDatabase(String).)

System_CAPS_pubmethodSystem_CAPS_staticChangePassword(String, SqlCredential, SecureString)

Ändert das SQL Server-Kennwort für den im SqlCredential-Objekt angegebenen Benutzer.

System_CAPS_pubmethodSystem_CAPS_staticChangePassword(String, String)

Ändert das SQL Server-Kennwort für den Benutzer, der in der Verbindungszeichenfolge zum bereitgestellten neuen Kennwort angegeben ist.

System_CAPS_pubmethodSystem_CAPS_staticClearAllPools()

Leert den Verbindungspool.

System_CAPS_pubmethodSystem_CAPS_staticClearPool(SqlConnection)

Leert den der angegebenen Verbindung zugeordneten Verbindungspool.

System_CAPS_pubmethodClose()

Schließt die Verbindung mit der Datenbank. Dies ist die bevorzugte Methode zum Schließen offener Verbindungen.(Überschreibt DbConnection.Close().)

System_CAPS_pubmethodCreateCommand()

Erstellt ein SqlCommand-Objekt, das der SqlConnection zugeordnet ist, und gibt es zurück.

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle vom Component verwendeten Ressourcen frei.(Geerbt von „Component“.)

System_CAPS_pubmethodEnlistDistributedTransaction(ITransaction)

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.

System_CAPS_pubmethodEnlistTransaction(Transaction)

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.(Überschreibt DbConnection.EnlistTransaction(Transaction).)

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetSchema()

Gibt Schemainformationen für die Datenquelle dieser SqlConnection zurück. Weitere Informationen zum Schema finden Sie unter SQL Server Schema Collections.(Überschreibt DbConnection.GetSchema().)

System_CAPS_pubmethodGetSchema(String)

Gibt Schemainformationen für die Datenquelle dieser SqlConnection mithilfe der angegebenen Zeichenfolge des Schemanamens.(Überschreibt DbConnection.GetSchema(String).)

System_CAPS_pubmethodGetSchema(String, String[])

Gibt Schemainformationen für die Datenquelle dieser SqlConnection mithilfe der angegebenen Zeichenfolge des Schemanamens und des angegebenen Zeichenfolgenarrays der Einschränkungswerte zurück.(Überschreibt DbConnection.GetSchema(String, String[]).)

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodOpen()

Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.(Überschreibt DbConnection.Open().)

System_CAPS_pubmethodOpenAsync()

Eine asynchrone Version der Open, die öffnet einer Verbindungs mit den angegebenen Einstellungen der ConnectionString. Diese Methode ruft die virtuelle Methode OpenAsync mit CancellationToken.None.(Geerbt von „DbConnection“.)

System_CAPS_pubmethodOpenAsync(CancellationToken)

Eine asynchrone Version von Open, die eine Datenbankverbindung mit den Eigenschaftseinstellungen öffnet, die durch ConnectionString angegeben sind. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout der Verbindung abläuft. Ausnahmen werden über die zurückgegebene Aufgabe weitergegeben. Wenn die Timeout-Zeit für die Verbindung abläuft, ohne die Verbindung erfolgreich herzustellen, wird die zurückgegebene Aufgabe als fehlgeschlagen mit einer Ausnahme markiert. Die Implementierung gibt eine Aufgabe zurück, ohne den aufrufenden Verbindungs-Thread zu blockieren (gilt auch für Pool-Verbindungen).(Überschreibt DbConnection.OpenAsync(CancellationToken).)

System_CAPS_pubmethodSystem_CAPS_staticRegisterColumnEncryptionKeyStoreProviders(IDictionary<String, SqlColumnEncryptionKeyStoreProvider>)

Registriert die Schlüsselspeicheranbieter für die Spaltenverschlüsselung.

System_CAPS_pubmethodResetStatistics()

Wenn die Statistikdatenerhebung aktiviert wird, werden alle Werte auf 0 (null) zurückgesetzt.

System_CAPS_pubmethodRetrieveStatistics()

Gibt eine Auflistung von Name-Wert-Paaren statistischer Daten zum Zeitpunkt des Methodenaufrufs zurück.

System_CAPS_pubmethodToString()

Gibt eine String mit dem Namen der Component, sofern vorhanden. Diese Methode darf nicht überschrieben werden.(Geerbt von „Component“.)

NameBeschreibung
System_CAPS_pubeventDisposed

Tritt auf, wenn die Komponente, durch einen Aufruf freigegeben wird der Dispose Methode.(Geerbt von „Component“.)

System_CAPS_pubeventInfoMessage

Tritt ein, wenn SQL Server eine Warn- oder Informationsmeldung zurückgibt.

System_CAPS_pubeventStateChange

Tritt ein, wenn der Zustand des Ereignisses geändert wird.(Geerbt von „DbConnection“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction()

Beginnt eine Datenbanktransaktion.(Geerbt von „DbConnection“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction(IsolationLevel)

Beginnt eine Datenbanktransaktion mit dem angegebenen IsolationLevel-Wert.(Geerbt von „DbConnection“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.CreateCommand()

Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück.(Geerbt von „DbConnection“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz darstellt.

Ein SqlConnection Objekt stellt eine eindeutige Sitzung mit einem SQL Server -Datenquelle. Mit einem Client/Server-Datenbanksystem ist es, eine Netzwerkverbindung mit dem Server entspricht. SqlConnectiondient zusammen mit SqlDataAdapter und SqlCommand zum Erhöhen der Leistung beim Verbinden mit einer Microsoft SQL Server Datenbank. Für alle Drittanbieter- SQL Server -Produkte und andere unterstützte OLE DB-Datenquellen verwenden OleDbConnection.

Beim Erstellen einer Instanz von SqlConnection, werden alle Eigenschaften auf ihre Ausgangswerte festgelegt. Eine Liste der folgenden Werte sind, finden Sie unter der SqlConnection Konstruktor.

Finden Sie unter ConnectionString eine Liste der Schlüsselwörter in einer Verbindungszeichenfolge.

Wenn die SqlConnection Gültigkeitsbereich verlässt, wird nicht geschlossen werden. Aus diesem Grund müssen Sie die Verbindung explizit schließen, durch den Aufruf Close oder Dispose. Closeund Dispose sind funktional äquivalent. Wenn der Wert des Verbindungspoolings Pooling festgelegt ist, um true oder yes, die zugrunde liegende Verbindung an den Verbindungspool zurückgegeben wird. Andererseits, wenn Pooling festgelegt ist, um false oder no, die die zugrunde liegende Verbindung mit dem Server tatsächlich geschlossen wird.

System_CAPS_noteHinweis

Wenn eine Verbindung aus dem Verbindungspool abgerufen oder an diesen zurückgegeben wird, werden keine Anmelde- und Abmeldeereignisse auf dem Server ausgelöst, da die Verbindung bei der Rückgabe an den Verbindungspool nicht geschlossen wird. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).

Um sicherzustellen, dass die Verbindungen immer geschlossen werden, öffnen Sie die Verbindung innerhalb von einer using block, wie im folgenden Codefragment dargestellt. Auf diese Weise wird sichergestellt, dass die Verbindung automatisch geschlossen wird, wenn der Code den Block beendet wird.

using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        // Do work here; connection closed on following line.
    }
System_CAPS_noteHinweis

Um leistungsstarke Anwendungen bereitzustellen, müssen Sie das Verbindungspooling verwenden. Bei Verwendung der .NET Framework -Datenanbieter für SQL Server, Sie müssen nicht aktivieren, Verbindungspooling, da der Anbieter automatisch verwaltet, obwohl Sie einige Einstellungen ändern können. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).

Wenn eine SqlException wird von der Methode ausgeführten generiert eine SqlCommand, die SqlConnection bleibt hergestellt, wenn der Schweregrad 19 oder darunter beträgt. Wenn der Schweregrad 20 oder größer ist, schließt der Server normalerweise die SqlConnection. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Eine Anwendung, die eine Instanz erstellt die SqlConnection Objekt kann alle direkten und indirekten Aufrufer damit ausreichende Berechtigungen, um den Code, durch Festlegen der deklarativen oder imperativen sicherheitsforderungen erfordern. SqlConnectionMithilfe von sicherheitsforderungen macht die SqlClientPermission Objekt. Benutzer können überprüfen, ob ihr Code mit über ausreichende Berechtigungen verfügt die SqlClientPermissionAttribute Objekt. Benutzer und Administratoren können auch die Caspol.exe (Code Access Security Policy Tool) Sicherheitsrichtlinie auf den Computer, Benutzer und Enterprise-Ebenen zu ändern. Weitere Informationen finden Sie unter Security in the .NET Framework. Das Beispiel mithilfe von sicherheitsforderungen, finden Sie unter Codezugriffssicherheit und ADO.NET.

Weitere Informationen zur Behandlung von Warnungen und sonstige Meldungen vom Server finden Sie unter 'Connection'-Ereignisse.SQL ServerDatenbankmodul-Fehler und Fehlermeldungen in dokumentiert sind SQL Server Books Online.

System_CAPS_cautionAchtung

Sie können anstelle von gemeinsam genutzten Speicher TCP erzwingen. Sie können dies vornehmen, indem voranstellen Tcp: auf den Servernamen in der Verbindungszeichenfolge einer Zeichenfolge oder Sie können "localhost" verwenden.

Das folgende Beispiel erstellt eine SqlCommand und ein SqlConnection. Die SqlConnection geöffnet ist, und legen Sie als die Connection für die SqlCommand. Das Beispiel ruft dann ExecuteNonQuery. Um dies zu erreichen der ExecuteNonQuery übergeben wird, eine Verbindungszeichenfolge und eine Abfragezeichenfolge, die eine Transact-SQL INSERT-Anweisung. Die Verbindung wird automatisch geschlossen, wenn der Code beendet die Verwendung wird Block.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

.NET Framework
Verfügbar seit 1.1

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: