SqlConnection Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

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

Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable

type SqlConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable

Vererbung

Object

MarshalByRefObject

Component

DbConnection

SqlConnection

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird eine SqlCommand und eine SqlConnection. Die SqlConnection Wird geöffnet und als für die ConnectionSqlCommand. Anschließend wird das Beispiel aufgerufen ExecuteNonQuery. Hierzu wird die ExecuteNonQuery eine SqlConnection und eine Abfragezeichenfolge übergeben, die eine Transact-SQL INSERT-Anweisung ist. Die Verbindung wird automatisch geschlossen, wenn der Code den using-Block verlässt.

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();
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Hinweise

Ein SqlConnection-Objekt stellt eine eindeutige Sitzung für eine SQL Server Datenquelle dar. Bei einem Client-/Serverdatenbanksystem entspricht es einer Netzwerkverbindung mit dem Server. SqlConnection wird zusammen mit SqlDataAdapter und SqlCommand verwendet, um die Leistung beim Herstellen einer Verbindung mit einem Microsoft SQL Server-Datenbank zu erhöhen. Verwenden Sie für alle Drittanbieter-SQL Server-Produkte und andere ole DB-unterstützte Datenquellen OleDbConnection.

Wenn Sie eine Instanz von /> erstellen, werden alle Eigenschaften auf ihre Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im SqlConnection Konstruktor.

Eine Liste der Schlüsselwörter in einem Verbindungszeichenfolge finden Sie unter ConnectionString.

Wenn der SqlConnection Bereich nicht mehr vorhanden ist, wird er nicht geschlossen. Daher müssen Sie die Verbindung explizit durch Aufrufen oder Close.Dispose Close und Dispose sind funktional gleichwertig. Wenn der Wert für den Verbindungspooling Pooling auf true oder yesfestgelegt ist, wird die zugrunde liegende Verbindung zurück an den Verbindungspool zurückgegeben. Auf der anderen Seite ist die zugrunde liegende Verbindung mit dem Server tatsächlich geschlossen, wenn Pooling sie auf oder falsediese festgelegt no ist.

Note

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 Connection Pooling (ADO.NET).

Um sicherzustellen, dass Verbindungen immer geschlossen sind, öffnen Sie die Verbindung innerhalb eines using Blocks, wie im folgenden Codefragment gezeigt. Dadurch wird sichergestellt, dass die Verbindung automatisch geschlossen wird, wenn der Code den Block verlässt.

Using connection As New SqlConnection(connectionString)
    connection.Open()
    ' Do work here; connection closed on following line.
End Using

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

Note

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

Wenn eine SqlException von der Methode generiert wird, die eine SqlCommandausführt, bleibt die SqlConnection geöffnet, wenn der Schweregrad 19 oder weniger beträgt. Wenn der Schweregrad 20 oder höher ist, schließt SqlConnectionder Server die . Der Benutzer kann die Verbindung jedoch erneut öffnen und fortfahren.

Eine Anwendung, die eine Instanz des SqlConnection Objekts erstellt, kann erfordern, dass alle direkten und indirekten Aufrufer über ausreichende Berechtigungen für den Code verfügen, indem sie deklarative oder imperative Sicherheitsanforderungen festlegen. SqlConnection stellt Sicherheitsanforderungen mithilfe des SqlClientPermission Objekts. Benutzer können überprüfen, ob ihr Code über ausreichende Berechtigungen verfügt, indem sie das SqlClientPermissionAttribute Objekt verwenden. Benutzer und Administratoren können auch das Caspol.exe (Code Access Security Policy Tool) verwenden, um die Sicherheitsrichtlinie auf Computer-, Benutzer- und Unternehmensebene zu ändern. Weitere Informationen finden Sie unter Sicherheit in .NET. Ein Beispiel zur Verwendung von Sicherheitsanforderungen finden Sie unter Code Access Security und ADO.NET.

Weitere Informationen zum Behandeln von Warnungen und Informationsmeldungen vom Server finden Sie unter "Verbindungsereignisse". Weitere Informationen zu SQL Server Modulfehlern und Fehlermeldungen finden Sie unter Datenbank-Engine Events and Errors.

Vorsicht

Sie können TCP anstelle des freigegebenen Speichers erzwingen. Dazu können Sie tcp: dem Servernamen im Verbindungszeichenfolge voranstellen oder localhost verwenden.

Konstruktoren

Name	Beschreibung
SqlConnection()	Initialisiert eine neue Instanz der SqlConnection-Klasse. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
SqlConnection(String, SqlCredential)	Initialisiert eine neue Instanz der SqlConnection Klasse mit einer Verbindungszeichenfolge, die nicht verwendet Integrated Security = true wird, und ein SqlCredential Objekt, das die Benutzer-ID und das Kennwort enthält. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
SqlConnection(String)	Initialisiert eine neue Instanz der SqlConnection Klasse, wenn eine Zeichenfolge angegeben wird, die die Verbindungszeichenfolge enthält. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.

Eigenschaften

Name	Beschreibung
AccessToken	Ruft das Zugriffstoken für die Verbindung ab oder legt es fest. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
ClientConnectionId	Die Verbindungs-ID des letzten Verbindungsversuchs, unabhängig davon, ob der Versuch erfolgreich war oder fehlgeschlagen ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ColumnEncryptionKeyCacheTtl	Dient zum Abrufen oder Festlegen der Zeit-zu-Live für Spaltenverschlüsselungsschlüsseleinträge im Spaltenverschlüsselungsschlüsselcache für das Feature "Immer verschlüsselt ". Der Standardwert beträgt 2 Stunden. 0 bedeutet überhaupt keine Zwischenspeicherung. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ColumnEncryptionQueryMetadataCacheEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zwischenspeicherung von Abfragemetadaten für parametrisierte Abfragen, die für Always Encrypted-aktivierte Datenbanken ausgeführt werden, aktiviert ist (true) oder nicht (false) aktiviert ist. Der Standardwert lautet „true“. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ColumnEncryptionTrustedMasterKeyPaths	Ermöglicht Ihnen, eine Liste von vertrauenswürdigen Schlüsselpfaden für einen Datenbankserver festzulegen. Wenn beim Verarbeiten einer Anwendungsabfrage der Treiber 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, die eine kompromittierte SQL Server bereitstellen gefälschte Schlüsselpfade, die zu einem Verlust von Schlüsselspeicheranmeldeinformationen führen können. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ConnectionString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die zum Öffnen einer SQL Server-Datenbank verwendet wird. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ConnectionTimeout	Ruft die Wartezeit (in Sekunden) ab, während versucht wird, eine Verbindung herzustellen, bevor der Versuch beendet und ein Fehler generiert wird. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Container	Ruft die IContainer ab, die den Componententhält. (Geerbt von Component)
Credential	Ruft ab oder legt das SqlCredential Objekt für diese Verbindung fest. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Database	Ruft den Namen der aktuellen Datenbank oder der Datenbank ab, die nach dem Öffnen einer Verbindung verwendet werden soll. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
DataSource	Ruft den Namen der Instanz von SQL Server ab, mit der eine Verbindung hergestellt werden soll. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
DbProviderFactory	Ruft dies DbProviderFactoryDbConnectionab. (Geerbt von DbConnection)
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component)
FireInfoMessageEventOnUserErrors	Dient zum Abrufen oder Festlegen der FireInfoMessageEventOnUserErrors Eigenschaft. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
PacketSize	Ruft die Größe (in Byte) von Netzwerkpaketen ab, die für die Kommunikation mit einer Instanz von SQL Server verwendet werden. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ServerVersion	Ruft eine Zeichenfolge ab, die die Version der Instanz von SQL Server enthält, mit der der Client verbunden ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
State	Gibt den Status des SqlConnection während des letzten Netzwerkvorgangs an, der für die Verbindung ausgeführt wurde. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
StatisticsEnabled	Bei Festlegung auf true, ermöglicht das Sammeln von Statistiken für die aktuelle Verbindung. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
WorkstationId	Ruft eine Zeichenfolge ab, die den Datenbankclient identifiziert. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.

Methoden

Name	Beschreibung
BeginDbTransaction(IsolationLevel)	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Datenbanktransaktion gestartet. (Geerbt von DbConnection)
BeginTransaction()	Startet eine Datenbanktransaktion. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
BeginTransaction(IsolationLevel, String)	Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe und dem Transaktionsnamen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
BeginTransaction(IsolationLevel)	Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
BeginTransaction(String)	Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ChangeDatabase(String)	Ändert die aktuelle Datenbank für eine geöffnete SqlConnectionDatenbank. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ChangePassword(String, SqlCredential, SecureString)	Ändert das SQL Server-Kennwort für den im SqlCredential-Objekt angegebenen Benutzer. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ChangePassword(String, String)	Ändert das SQL Server-Kennwort für den Benutzer, der in der Verbindungszeichenfolge angegeben ist, in das angegebene neue Kennwort. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ClearAllPools()	Leert den Verbindungspool. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ClearPool(SqlConnection)	Leert den Verbindungspool, der der angegebenen Verbindung zugeordnet ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Close()	Schließt die Verbindung mit der Datenbank. Dies ist die bevorzugte Methode zum Schließen einer geöffneten Verbindung. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
CreateCommand()	Erstellt und gibt ein SqlCommand Objekt zurück, das der SqlConnection. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
CreateDbCommand()	Wenn eine abgeleitete Klasse überschrieben wird, wird ein DbCommand Objekt erstellt und zurückgegeben, das der aktuellen Verbindung zugeordnet ist. (Geerbt von DbConnection)
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
EnlistDistributedTransaction(ITransaction)	Enlists in der angegebenen Transaktion als verteilte Transaktion. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
EnlistTransaction(Transaction)	Enlists in der angegebenen Transaktion als verteilte Transaktion. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSchema()	Gibt Schemainformationen für die Datenquelle dieses Werts SqlConnectionzurück. Weitere Informationen zum Schema finden Sie unter SQL Server Schemasammlungen. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
GetSchema(String, String[])	Gibt Schemainformationen für die Datenquelle zurück SqlConnection , die die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
GetSchema(String)	Gibt Schemainformationen für die Datenquelle zurück SqlConnection , die die angegebene Zeichenfolge für den Schemanamen verwendet. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Löst das StateChange-Ereignis aus. (Geerbt von DbConnection)
Open()	Öffnet eine Datenbankverbindung mit den eigenschafteneinstellungen, die durch die ConnectionString. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
OpenAsync()	Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den einstellungen öffnet, die durch die ConnectionString. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbConnection)
OpenAsync(CancellationToken)	Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den eigenschafteneinstellungen öffnet, die durch die ConnectionString. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Verbindungstimeout verstrichen ist. Ausnahmen werden über den zurückgegebenen Vorgang weitergegeben. Wenn die Zeitüberschreitung der Verbindung ohne erfolgreiche Verbindung verstrichen ist, wird der zurückgegebene Vorgang mit einer Ausnahme als fehlerhaft markiert. Die Implementierung gibt eine Aufgabe zurück, ohne den aufrufenden Thread für poolierte und nicht poolierte Verbindungen zu blockieren. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>)	Registriert die Anbieter des Spaltenverschlüsselungsschlüsselspeichers. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ResetStatistics()	Wenn das Sammeln von Statistiken aktiviert ist, werden alle Werte auf Null zurückgesetzt. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
RetrieveStatistics()	Gibt eine Name value pair collection of statistics at the point in time the method is called. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
ToString()	Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Events

Name	Beschreibung
Disposed	Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() -Methode verworfen wird. (Geerbt von Component)
InfoMessage	Tritt auf, wenn SQL Server eine Warnung oder Informationsmeldung zurückgibt. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
StateChange	Tritt auf, wenn sich der Status der Verbindung ändert. (Geerbt von DbConnection)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICloneable.Clone()	Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz ist. Verwenden Sie für die neue Entwicklung Microsoft. Data.SqlClient. Diese Seite dokumentiert System.Data.SqlClient.
IDbConnection.BeginTransaction()	Beginnt eine Datenbanktransaktion. (Geerbt von DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe. (Geerbt von DbConnection)
IDbConnection.CreateCommand()	Erstellt und gibt ein DbCommand Objekt zurück, das der aktuellen Verbindung zugeordnet ist. (Geerbt von DbConnection)

Siehe auch

• Herstellen einer Verbindung mit einer Datenquelle in ADO.NET
• SQL Server und ADO.NET
• Übersicht über ADO.NET