DbConnection DbConnection DbConnection DbConnection Class

Definition

Stellt eine Verbindung mit 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

Beim Erben von DbConnection, 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. Sie müssen auch die folgenden Eigenschaften angeben: ConnectionString, Database, DataSource, ServerVersion, und 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

Übernimmt oder bestimmt die Zeichenfolge, die zum Öffnen der Verbindung verwendet.Gets or sets the string used to open the connection.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Ruft den Zeitpunkt zu warten, die beim Herstellen einer Verbindung, bevor der Versuch beendet und ein Fehler generiert.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, nachdem eine Verbindung hergestellt wird oder den Datenbanknamen in der Verbindungszeichenfolge angegeben werden, 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, der eine Verbindung herstellen.Gets the name of the database server to which to connect.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

Ruft den DbProviderFactory für diesen 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, die die Version des Servers darstellt, 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 die ISite der Component ab oder legt diese fest.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Ruft eine Zeichenfolge, 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.

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.

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

Ändert die aktuelle Datenbank für eine geöffnete Verbindung an.Changes the current database for an open 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 und gibt eine DbCommand Objekt der aktuellen Verbindung zugeordnet.Creates and returns a DbCommand object associated with the current connection.

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

Erstellt und gibt eine DbCommand Objekt der aktuellen Verbindung zugeordnet.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)
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

In der angegebenen Transaktion eingetragen.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 Einstellungen, die gemäß der ConnectionString.Opens a database connection with the settings specified by the ConnectionString.

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

Eine asynchrone Version von Open(), die öffnet eine datenbankverbindung mit den Einstellungen, die gemäß der ConnectionString.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 die synchrone Open() aufrufen 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. Von Open ausgelöste Ausnahmen werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Rufen Sie andere Methoden und Eigenschaften nicht den DbConnection Objekt, 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 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)
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