SqlConnection SqlConnection SqlConnection SqlConnection Class

Definition

Stellt eine Verbindung zu einer SQL Server-Datenbank dar.Represents a connection to a SQL Server database. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class SqlConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public sealed class SqlConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
type SqlConnection = class
    inherit DbConnection
    interface IDbConnection
    interface ICloneable
    interface IDisposable
Public NotInheritable Class SqlConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Vererbung
Implementiert

Beispiele

Das folgende Beispiel erstellt eine SqlCommand und SqlConnection.The following example creates a SqlCommand and a SqlConnection. Die SqlConnection wird geöffnet, und legen Sie als die Connection für die SqlCommand.The SqlConnection is opened and set as the Connection for the SqlCommand. Das Beispiel ruft dann ExecuteNonQuery.The example then calls ExecuteNonQuery. Zu diesem Zweck die ExecuteNonQuery übergeben wird, eine Verbindungszeichenfolge und eine Abfragezeichenfolge, die eine Transact-SQLTransact-SQL INSERT-Anweisung.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is a Transact-SQLTransact-SQL INSERT statement. Die Verbindung wird automatisch geschlossen, wenn der Code verlässt die mit Block.The connection is closed automatically when the code exits the using 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();
    }
}
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 mit einer SQL Server-Datenquelle dar.A SqlConnection object represents a unique session to a SQL Server data source. Mit einem Client/Server-Datenbanksystem ist es eine Netzwerkverbindung mit dem Server entspricht.With a client/server database system, it is equivalent to a network connection to the server. SqlConnection dient zusammen mit SqlDataAdapter und SqlCommand zum Herstellen der Verbindung mit einer Microsoft SQL Server-Datenbank die Leistung zu steigern.SqlConnection is used together with SqlDataAdapter and SqlCommand to increase performance when connecting to a Microsoft SQL Server database. Verwenden Sie für alle SQL Server-Produkte von Drittanbietern und andere unterstützte OLE DB-Datenquellen OleDbConnection.For all third-party SQL Server products and other OLE DB-supported data sources, use OleDbConnection.

Beim Erstellen einer Instanz von SqlConnection, alle Eigenschaften auf die ursprünglichen Werte festgelegt sind.When you create an instance of SqlConnection, all properties are set to their initial values. Eine Liste dieser Werte finden Sie in der SqlConnection Konstruktor.For a list of these values, see the SqlConnection constructor.

Finden Sie unter ConnectionString eine Liste der Schlüsselwörter in einer Verbindungszeichenfolge.See ConnectionString for a list of the keywords in a connection string.

Wenn die SqlConnection Gültigkeitsbereich verlässt, wird nicht geschlossen werden.If the SqlConnection goes out of scope, it won't be closed. Aus diesem Grund müssen Sie die Verbindung explizit schließen, durch den Aufruf Close oder Dispose.Therefore, you must explicitly close the connection by calling Close or Dispose. Close und Dispose sind funktional äquivalent.Close and Dispose are functionally equivalent. Wenn der Wert des Verbindungspoolings Pooling nastaven NA hodnotu true oder yes, wird die zugrunde liegende Verbindung wird zurück an den Verbindungspool zurückgegeben.If the connection pooling value Pooling is set to true or yes, the underlying connection is returned back to the connection pool. Andererseits, wenn Pooling nastaven NA hodnotu false oder no, wird die zugrunde liegende Verbindung mit dem Server geschlossen wird.On the other hand, if Pooling is set to false or no, the underlying connection to the server is actually closed.

Hinweis

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.Login and logout events will not be raised on the server when a connection is fetched from or returned to the connection pool, because the connection is not actually closed when it is returned to the connection pool. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

Um sicherzustellen, dass die Verbindungen immer geschlossen werden, öffnen Sie die Verbindung innerhalb von einer using blockieren, wie im folgenden Codefragment dargestellt.To ensure that connections are always closed, open the connection inside of a using block, as shown in the following code fragment. Dadurch wird sichergestellt, dass die Verbindung automatisch geschlossen wird, wenn der Code den Block beendet wird.Doing so ensures that the connection is automatically closed when the code exits the block.

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.  
    }  

Hinweis

Um Anwendungen mit hoher Leistung bereitstellen zu können, müssen Sie das Verbindungspooling verwenden.To deploy high-performance applications, you must use connection pooling. Wenn Sie die .NET Framework-Datenanbieter für SQL Server verwenden, müssen Sie keinen Verbindungs-pooling, da der Anbieter automatisch verwaltet, obwohl Sie, einige Einstellungen ändern können zu aktivieren.When you use the .NET Framework Data Provider for SQL Server, you do not have to enable connection pooling because the provider manages this automatically, although you can modify some settings. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

Wenn eine SqlException wird generiert, indem Sie Ausführung der Methode eine SqlCommand, SqlConnection geöffnet bleibt, wenn der Schweregrad 19 oder darunter beträgt.If a SqlException is generated by the method executing a SqlCommand, the SqlConnection remains open when the severity level is 19 or less. Wenn der Schweregrad 20 oder höher ist, schließt der Server normalerweise die SqlConnection.When the severity level is 20 or greater, the server ordinarily closes the SqlConnection. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.However, the user can reopen the connection and continue.

Eine Anwendung, die eine Instanz erstellt die SqlConnection Objekt kann festlegen, dass alle direkten und indirekten Aufrufer über ausreichende Berechtigungen, um den Code durch Festlegen von Anforderungen mit deklarative oder imperative Sicherheit haben.An application that creates an instance of the SqlConnection object can require all direct and indirect callers to have sufficient permission to the code by setting declarative or imperative security demands. SqlConnection Mithilfe von sicherheitsforderungen macht die SqlClientPermission Objekt.SqlConnection makes security demands using the SqlClientPermission object. Benutzer können überprüfen, ob es sich bei ihren Code über ausreichende Berechtigungen mit dem die SqlClientPermissionAttribute Objekt.Users can verify that their code has sufficient permissions by using the SqlClientPermissionAttribute object. Benutzer und Administratoren können auch die Caspol.exe (Code Access Security Policy-Tool) Sicherheitsrichtlinie auf den Computer-, Benutzer- und Enterprise-Ebenen zu ändern.Users and administrators can also use the Caspol.exe (Code Access Security Policy Tool) to modify security policy at the machine, user, and enterprise levels. Weitere Informationen finden Sie unter Sicherheit in .NET.For more information, see Security in .NET. Ein Beispiel veranschaulicht, wie von sicherheitsanforderungen, finden Sie unter Codezugriffssicherheit und ADO.NET.For an example demonstrating how to use security demands, see Code Access Security and ADO.NET.

Weitere Informationen zur Behandlung von Warnungen und sonstige Meldungen auf dem Server finden Sie unter Verbindungsereignisse.For more information about handling warning and informational messages from the server, see Connection Events. Weitere Informationen zu SQL Server-Engine-Fehlern und Meldungen finden Sie unter Datenbank-Engine-Fehler und Ereignisse.For more information about SQL Server engine errors and error messages, see Database Engine Events and Errors.

Achtung

Sie können TCP erzwingen, statt im freigegebenen Speicher.You can force TCP instead of shared memory. Sie können dies durch Voranstellen von Tcp: auf den Namen des Servers in der Verbindung einer Zeichenfolge oder Sie können "localhost" verwenden.You can do that by prefixing tcp: to the server name in the connection string or you can use localhost.

Konstruktoren

SqlConnection() SqlConnection() SqlConnection() SqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.Initializes a new instance of the SqlConnection class.

SqlConnection(String) SqlConnection(String) SqlConnection(String) SqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(String, SqlCredential) SqlConnection(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.Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

Eigenschaften

AccessToken AccessToken AccessToken AccessToken

Ruft das Zugriffstoken für die Verbindung ab oder legt es fest.Gets or sets the access token for the connection.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ClientConnectionId ClientConnectionId ClientConnectionId ClientConnectionId

Die Verbindungs-ID der letzten Verbindungsversuchs, unabhängig davon, ob der Versuch erfolgreich war oder fehlgeschlagen ist.The connection ID of the most recent connection attempt, regardless of whether the attempt succeeded or failed.

ColumnEncryptionKeyCacheTtl ColumnEncryptionKeyCacheTtl ColumnEncryptionKeyCacheTtl ColumnEncryptionKeyCacheTtl

Ruft die Gültigkeitsdauer der Einträge für die Spaltenverschlüsselungsschlüssel im entsprechenden Cache für das Always Encrypted-Feature ab oder legt die Dauer fest.Gets or sets the time-to-live for column encryption key entries in the column encryption key cache for the Always Encrypted feature. Der Standardwert ist 2 Stunden.The default value is 2 hours. 0 bedeutet, dass keine Zwischenspeicherung stattfindet.0 means no caching at all.

ColumnEncryptionQueryMetadataCacheEnabled ColumnEncryptionQueryMetadataCacheEnabled ColumnEncryptionQueryMetadataCacheEnabled ColumnEncryptionQueryMetadataCacheEnabled

Ruft einen Wert ab, der angibt, ob das Zwischenspeichern von Abfragemetadaten für parametrisierte Abfragen in Always Encrypted-fähigen Datenbanken aktiviert (TRUE) oder nicht aktiviert (FALSE) ist, oder legt diesen Wert fest.Gets or sets a value that indicates whether query metadata caching is enabled (true) or not (false) for parameterized queries running against Always Encrypted enabled databases. Der Standardwert ist true.The default value is true.

ColumnEncryptionTrustedMasterKeyPaths ColumnEncryptionTrustedMasterKeyPaths ColumnEncryptionTrustedMasterKeyPaths ColumnEncryptionTrustedMasterKeyPaths

Ermöglicht es Ihnen, eine Liste von vertrauenswürdigen Schlüsselpfaden für einen Datenbankserver festzulegen.Allows you to set a list of trusted key paths for a database server. 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.If while processing an application query the driver receives a key path that is not on the list, the query will fail. 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.This property provides additional protection against security attacks that involve a compromised SQL Server providing fake key paths, which may lead to leaking key store credentials.

ConnectionString ConnectionString ConnectionString ConnectionString

Ruft die Zeichenfolge ab, mit der eine SQL Server-Datenbank geöffnet wird, oder legt diese fest.Gets or sets the string used to open a SQL Server database.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Ruft die Zeit ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird.Gets the time to wait while trying to establish a connection before terminating the attempt and generating an error.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
Credential Credential Credential Credential

Ruft das SqlCredential-Objekt für diese Verbindung ab, oder legt es fest.Gets or sets the SqlCredential object for this connection.

Credentials Credentials Credentials Credentials
Database Database Database Database

Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung zu verwendenden Datenbank ab.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Ruft den Namen der SQL Server-Instanz ab, mit der eine Verbindung hergestellt werden soll.Gets the name of the instance of SQL Server to which to connect.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FireInfoMessageEventOnUserErrors FireInfoMessageEventOnUserErrors FireInfoMessageEventOnUserErrors FireInfoMessageEventOnUserErrors

Ruft die FireInfoMessageEventOnUserErrors-Eigenschaft ab oder legt diese fest.Gets or sets the FireInfoMessageEventOnUserErrors property.

PacketSize PacketSize PacketSize PacketSize

Ruft die Größe der Netzwerkpakete in Bytes ab, die zum Kommunizieren mit einer Instanz von SQL Server verwendet werden.Gets the size (in bytes) of network packets used to communicate with an instance of SQL Server.

ServerVersion ServerVersion ServerVersion ServerVersion

Ruft eine Zeichenfolge mit der Version der SQL Server-Instanz ab, mit der der Client verbunden ist.Gets a string that contains the version of the instance of SQL Server to which the client is connected.

Site Site Site Site

Ruft die ISite der Component ab oder legt diese fest.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Gibt den Zustand von SqlConnection während des letzten Netzwerkvorgangs an, der für die Verbindung ausgeführt wurde.Indicates the state of the SqlConnection during the most recent network operation performed on the connection.

StatisticsEnabled StatisticsEnabled StatisticsEnabled StatisticsEnabled

Wenn true, wird für die aktuelle Verbindung die Statistikdatenerhebung aktiviert.When set to true, enables statistics gathering for the current connection.

WorkstationId WorkstationId WorkstationId WorkstationId

Ruft eine Zeichenfolge ab, die den Datenbankclient bezeichnet.Gets a string that identifies the database client.

Methoden

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Startet eine Datenbanktransaktion.Starts a database transaction.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad.Starts a database transaction with the specified isolation level.

BeginTransaction(IsolationLevel, String) BeginTransaction(IsolationLevel, String) BeginTransaction(IsolationLevel, String) BeginTransaction(IsolationLevel, String)

Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad und Transaktionsnamen.Starts a database transaction with the specified isolation level and transaction name.

BeginTransaction(String) BeginTransaction(String) BeginTransaction(String) BeginTransaction(String)

Startet eine Datenbanktransaktion mit dem angegebenen Transaktionsnamen.Starts a database transaction with the specified transaction name.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Ändert die aktuelle Datenbank für eine offene SqlConnection.Changes the current database for an open SqlConnection.

ChangePassword(String, SqlCredential, SecureString) ChangePassword(String, SqlCredential, SecureString) ChangePassword(String, SqlCredential, SecureString) ChangePassword(String, SqlCredential, SecureString)

Ändert das SQL Server-Kennwort für den Benutzer, der im SqlCredential-Objekt angegeben wird.Changes the SQL Server password for the user indicated in the SqlCredential object.

ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String) ChangePassword(String, String)

Ändert das SQL Server-Kennwort für den Benutzer, der in der Verbindungszeichenfolge zum bereitgestellten neuen Kennwort angegeben ist.Changes the SQL Server password for the user indicated in the connection string to the supplied new password.

ClearAllPools() ClearAllPools() ClearAllPools() ClearAllPools()

Leert den Verbindungspool.Empties the connection pool.

ClearPool(SqlConnection) ClearPool(SqlConnection) ClearPool(SqlConnection) ClearPool(SqlConnection)

Leert den der angegebenen Verbindung zugeordneten Verbindungspool.Empties the connection pool associated with the specified connection.

Close() Close() Close() Close()

Schließt die Verbindung mit der Datenbank.Closes the connection to the database. Dies ist die bevorzugte Methode zum Schließen offener Verbindungen.This is the preferred method of closing any open connection.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Erstellt ein SqlCommand-Objekt, das der SqlConnection zugeordnet ist, und gibt es zurück.Creates and returns a SqlCommand object associated with the SqlConnection.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction)

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.Enlists in the specified transaction as a distributed transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSchema() GetSchema() GetSchema() GetSchema()

Gibt Schemainformationen für die Datenquelle dieser SqlConnection zurück.Returns schema information for the data source of this SqlConnection. Weitere Informationen zu Schemas finden Sie unter SQL Server-Schemaauflistungen.For more information about scheme, see SQL Server Schema Collections.

GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

Gibt Schemainformationen für die Datenquelle dieser SqlConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück.Returns schema information for the data source of this SqlConnection using the specified string for the schema name.

GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(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.Returns schema information for the data source of this SqlConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Open() Open() Open() Open()

Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.Opens a database connection with the property settings specified by the ConnectionString.

OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken)

Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Eigenschaftseinstellungen öffnet, die durch ConnectionString angegeben sind.An asynchronous version of Open(), which opens a database connection with the property settings specified by the ConnectionString. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout der Verbindung abläuft.The cancellation token can be used to request that the operation be abandoned before the connection timeout elapses. Ausnahmen werden über die zurückgegebene Aufgabe weitergegeben.Exceptions will be propagated via the returned Task. 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.If the connection timeout time elapses without successfully connecting, the returned Task will be marked as faulted with an Exception. Die Implementierung gibt eine Aufgabe zurück, ohne den aufrufenden Verbindungs-Thread zu blockieren (gilt auch für Pool-Verbindungen).The implementation returns a Task without blocking the calling thread for both pooled and non-pooled connections.

RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>) RegisterColumnEncryptionKeyStoreProviders(IDictionary<String,SqlColumnEncryptionKeyStoreProvider>)

Registriert die Schlüsselspeicheranbieter für die Spaltenverschlüsselung.Registers the column encryption key store providers.

ResetStatistics() ResetStatistics() ResetStatistics() ResetStatistics()

Wenn die Statistikdatenerhebung aktiviert wird, werden alle Werte auf 0 (null) zurückgesetzt.If statistics gathering is enabled, all values are reset to zero.

RetrieveStatistics() RetrieveStatistics() RetrieveStatistics() RetrieveStatistics()

Gibt eine Auflistung von Name-Wert-Paaren statistischer Daten zum Zeitpunkt des Methodenaufrufs zurück.Returns a name value pair collection of statistics at the point in time the method is called.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen dieser Component enthält, sofern vorhanden.Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Tritt ein, wenn SQL Server eine Warn- oder Informationsmeldung zurückgibt.Occurs when SQL Server returns a warning or informational message.

StateChange StateChange StateChange StateChange

Tritt auf, wenn der Status der Verbindung geändert.Occurs when the state of the connection changes.

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz darstellt.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Beginnt eine Datenbanktransaktion.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Beginnt eine Datenbanktransaktion mit dem angegebenen IsolationLevel-Wert.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Erstellt ein Command-Objekt, das der Verbindung zugeordnet ist, und gibt dieses zurück.Creates and returns a Command object that is associated with the connection.

Gilt für:

Siehe auch