DbConnection DbConnection DbConnection DbConnection Class

Definition

Stellt eine Verbindung zu einer Datenbank dar.Represents a connection to a database.

public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Vererbung
Abgeleitet
Implementiert

Hinweise für Vererber

Wenn DbConnectionSie von erben, müssen Sie die folgenden Member überschreiben Close(): BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), und StateChange.When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Außerdem müssen Sie die folgenden Eigenschaften angeben: ConnectionString, Database, DataSource, ServerVersionund State.You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Konstruktoren

DbConnection() DbConnection() DbConnection() DbConnection()

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

Eigenschaften

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)
ConnectionString ConnectionString ConnectionString ConnectionString

Ruft die Zeichenfolge ab, mit der die Verbindung geöffnet wird, oder legt diese fest.Gets or sets the string used to open the connection.

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 establishing 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)
Database Database Database Database

Ruft den Namen der aktuellen Datenbank ab, nachdem eine Verbindung geöffnet wurde, oder ruft den in der Verbindungszeichenfolge angegebenen Datenbanknamen ab, bevor die Verbindung geöffnet wird.Gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource DataSource DataSource DataSource

Ruft den Namen des Datenbankservers ab, mit dem eine Verbindung hergestellt werden soll.Gets the name of the database server to which to connect.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

Ruft das DbProviderFactory für dieses DbConnection ab.Gets the DbProviderFactory for this DbConnection.

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)
ServerVersion ServerVersion ServerVersion ServerVersion

Ruft eine Zeichenfolge ab, die die Version des Servers darstellt, mit der das Objekt verbunden ist.Gets a string that represents the version of the server to which the object is connected.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Ruft eine Zeichenfolge ab, die den Zustand der Verbindung beschreibt.Gets a string that describes the state of the connection.

Methoden

BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel)

Startet eine Datenbanktransaktion.Starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken)
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.

BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken)
BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken)
ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Wechselt die aktuelle Datenbank für eine geöffnete Verbindung.Changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken)
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.

CloseAsync() CloseAsync() CloseAsync() CloseAsync()
CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand() CreateDbCommand() CreateDbCommand() CreateDbCommand()

Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück.Creates and returns a DbCommand object associated with the current connection.

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()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Führt zu einem Eintrag in der angegebenen Transaktion.Enlists in the specified 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 DbConnection zurück.Returns schema information for the data source of this DbConnection.

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

Gibt Schemainformationen für die Datenquelle dieser DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück.Returns schema information for the data source of this DbConnection 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 DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens und des angegebenen Zeichenfolgenarrays der Einschränkungswerte zurück.Returns schema information for the data source of this DbConnection 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)
OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs)

Löst das StateChange-Ereignis aus.Raises the StateChange event.

Open() Open() Open() Open()

Öffnet eine Datenbankverbindung mit den durch ConnectionString angegebenen Einstellungen.Opens a database connection with the settings specified by the ConnectionString.

OpenAsync() OpenAsync() OpenAsync() OpenAsync()

Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Einstellungen öffnet, die durch ConnectionString angegeben werden.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

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

Dies ist die asynchrone Version von Open().This is the asynchronous version of Open(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional berücksichtigt werden.The cancellation token can optionally be honored.

Die Standardimplementierung ruft den asynchronen Open()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück.The default implementation invokes the synchronous Open() call and returns a completed task. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Die Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbConnection-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

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

Gibt einen String zurück, der den Namen der 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)
StateChange StateChange StateChange StateChange

Tritt ein, wenn der Zustand des Ereignisses geändert wird.Occurs when the state of the event changes.

Explizite Schnittstellenimplementierungen

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 DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück.Creates and returns a DbCommand object that is associated with the current connection.

Gilt für:

Siehe auch