DbConnection Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Definiert das Kernverhalten der Datenbankverbindungen und stellt eine Basisklasse für datenbankspezifische Verbindungen bereit

public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable

Vererbung

Object

MarshalByRefObject

Component

DbConnection

Abgeleitet

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implementiert

IDisposable IDbConnection IAsyncDisposable

Hinweise für Ausführende

Wenn Sie von erbenDbConnection, müssen Sie die folgenden Member überschreiben: Close(), , ChangeDatabase(String)BeginDbTransaction(IsolationLevel), CreateDbCommand(), Open()und StateChange. Außerdem müssen Sie die folgenden Eigenschaften angeben: ConnectionString, Database, DataSource, ServerVersionund State.

Konstruktoren

DbConnection()

Initialisiert eine neue Instanz der DbConnection-Klasse.

Eigenschaften

CanCreateBatch	Ruft einen Wert ab, der angibt, ob diese DbConnection-Instanz die DbBatch-Klasse unterstützt
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
ConnectionString	Ruft beim Überschreiben in einer abgeleiteten Klasse die Zeichenfolge, die für die Verbindung benötigt wird, ab oder legt sie fest
ConnectionTimeout	Ruft die Zeit (in Sekunden) ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
Database	Ruft beim Überschreiben in einer abgeleiteten Klasse 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
DataSource	Ruft beim Überschreiben in einer abgeleiteten Klasse den Namen des Datenbankservers ab, zu dem die Verbindung hergestellt werden soll
DbProviderFactory	Ruft den DbProviderFactory für diesen DbConnection ab.
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
ServerVersion	Ruft beim Überschreiben in einer abgeleiteten Klasse eine Zeichenfolge ab, die die Version des Servers darstellt, mit der das Objekt verbunden ist
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
State	Ruft eine Zeichenfolge ab, die den Zustand der Verbindung beschreibt.

Methoden

BeginDbTransaction(IsolationLevel)	Startet beim Überschreiben in einer abgeleiteten Klasse eine Datenbanktransaktion
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Startet asynchron eine Datenbanktransaktion
BeginTransaction()	Startet eine Datenbanktransaktion.
BeginTransaction(IsolationLevel)	Startet eine Datenbanktransaktion mit dem angegebenen Isolationsgrad.
BeginTransactionAsync(CancellationToken)	Startet asynchron eine Datenbanktransaktion
BeginTransactionAsync(IsolationLevel, CancellationToken)	Startet asynchron eine Datenbanktransaktion
ChangeDatabase(String)	Ändert beim Überschreiben in einer abgeleiteten Klasse die aktuelle Datenbank für eine geöffnete Verbindung
ChangeDatabaseAsync(String, CancellationToken)	Ändert asynchron die aktuelle Datenbank für eine offene Verbindung
Close()	Schließt beim Überschreiben in einer abgeleiteten Klasse die Verbindung zur Datenbank
CloseAsync()	Schließt asynchron die Verbindung mit der Datenbank
CreateBatch()	Gibt eine neue Instanz der Klasse des Anbieters zurück, die die DbBatch-Klasse implementiert.
CreateCommand()	Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück.
CreateDbBatch()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine neue instance der Klasse des Anbieters zurück, die die DbBatch Klasse implementiert.
CreateDbCommand()	Erstellt beim Überschreiben in einer abgeleiteten Klasse ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt es zurück
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
DisposeAsync()	Stellt das Verbindungsobjekt asynchron bereit
EnlistTransaction(Transaction)	Führt zu einem Eintrag in der angegebenen Transaktion.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSchema()	Gibt Schemainformationen für die Datenquelle dieser DbConnection zurück.
GetSchema(String)	Gibt Schemainformationen für die Datenquelle dieser DbConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück.
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.
GetSchemaAsync(CancellationToken)	Dies ist eine asynchrone Version von GetSchema(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.
GetSchemaAsync(String, CancellationToken)	Dies ist die asynchrone Version von GetSchema(String). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema(String)-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema(String) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.
GetSchemaAsync(String, String[], CancellationToken)	Dies ist die asynchrone Version von GetSchema(String, String[]). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchema(String, String[])-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchema(String, String[]) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des 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.
Open()	Öffnet beim Überschreiben in einer abgeleiteten Klasse eine Datenbankverbindung mit den Einstellungen, die durch ConnectionString angegeben werden
OpenAsync()	Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Einstellungen öffnet, die durch ConnectionString angegeben werden. Diese Methode ruft die virtuelle Methode OpenAsync(CancellationToken) mit CancellationToken.None auf.
OpenAsync(CancellationToken)	Dies ist die asynchrone Version von Open(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen Open()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten hat. Die Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbConnection-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
StateChange	Tritt auf, wenn sich der Status der Verbindung ändert.

Explizite Schnittstellenimplementierungen

IDbConnection.BeginTransaction()	Beginnt eine Datenbanktransaktion.
IDbConnection.BeginTransaction(IsolationLevel)	Beginnt eine Datenbanktransaktion mit der angegebenen Isolationsstufe.
IDbConnection.CreateCommand()	Erstellt ein DbCommand-Objekt, das der aktuellen Verbindung zugeordnet ist, und gibt dieses zurück.

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET