DbConnection Klasse

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class DbConnection abstract : IDisposable

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

public ref class DbConnection abstract : IDisposable, System::Data::IDbConnection

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

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

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

public abstract class DbConnection : IDisposable

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

public abstract class DbConnection : IDisposable, System.Data.IDbConnection

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

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

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

type DbConnection = class
    interface IDisposable

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

type DbConnection = class
    interface IDbConnection
    interface IDisposable

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable

Public MustInherit Class DbConnection
Implements IDisposable

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

Public MustInherit Class DbConnection
Implements IDbConnection, IDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection

Vererbung: Object
DbConnection

Vererbung: Object

MarshalByRefObject

Component
DbConnection

Abgeleitet: System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.OracleClient.OracleConnection

System.Data.SqlClient.SqlConnection

Implementiert: IDisposable IDbConnection IAsyncDisposable

Hinweise für Ausführende

Wenn Sie von erbenDbConnection, müssen Sie die folgenden Mitglieder außer Kraft setzen: Close(), BeginDbTransaction(IsolationLevel), CreateDbCommand()ChangeDatabase(String)Open()und StateChange. Sie müssen auch die folgenden Eigenschaften bereitstellen: 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()	Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, wird eine neue Instanz der Klasse des Anbieters zurückgegeben, 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()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von DbConnection verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
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 eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
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.

Gilt für