DbConnection Klasse

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Quelle:: DbConnection.cs

Quelle:: DbConnection.cs

Quelle:: DbConnection.cs

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 von 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 DbConnectionerben, müssen Sie die folgenden Member außer Kraft setzen: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), 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 die zum Öffnen der Verbindung verwendete Zeichenfolge ab, wenn sie in einer abgeleiteten Klasse überschrieben wird, oder legt sie fest.
ConnectionTimeout	Ruft die Wartezeit (in Sekunden) ab, während eine Verbindung hergestellt wird, bevor der Versuch beendet und ein Fehler generiert wird.
Container	Ruft die IContainer ab, die den Componententhält. (Geerbt von Component)
Database	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft den Namen der aktuellen Datenbank nach dem Öffnen einer Verbindung oder den in der Verbindungszeichenfolge angegebenen Datenbanknamen ab, bevor die Verbindung geöffnet wird.
DataSource	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Name des Datenbankservers abgerufen, mit dem eine Verbindung hergestellt werden soll.
DbProviderFactory	Ruft die DbProviderFactory für diese DbConnectionab.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component)
ServerVersion	Beim Überschreiben in einer abgeleiteten Klasse ruft eine Zeichenfolge ab, die die Version des Servers darstellt, mit dem das Objekt verbunden ist.
Site	Dient zum Abrufen oder Festlegen des ISite des Component. (Geerbt von Component)
State	Ruft eine Zeichenfolge ab, die den Status der Verbindung beschreibt.

Methoden

BeginDbTransaction(IsolationLevel)	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Datenbanktransaktion gestartet.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Startet asynchron eine Datenbanktransaktion.
BeginTransaction()	Startet eine Datenbanktransaktion.
BeginTransaction(IsolationLevel)	Startet eine Datenbanktransaktion mit der angegebenen Isolationsstufe.
BeginTransactionAsync(CancellationToken)	Beginnt asynchron eine Datenbanktransaktion.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Beginnt asynchron eine Datenbanktransaktion.
ChangeDatabase(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die aktuelle Datenbank für eine geöffnete Verbindung geändert.
ChangeDatabaseAsync(String, CancellationToken)	Ändert asynchron die aktuelle Datenbank für eine geöffnete Verbindung.
Close()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Verbindung mit der Datenbank geschlossen.
CloseAsync()	Schließt die Verbindung mit der Datenbank asynchron.
CreateBatch()	Gibt eine neue Instanz der Anbieterklasse zurück, die die DbBatch Klasse implementiert.
CreateCommand()	Erstellt und gibt ein DbCommand Objekt zurück, das der aktuellen Verbindung zugeordnet ist.
CreateDbBatch()	Wenn eine abgeleitete Klasse überschrieben wird, wird eine neue Instanz der Klasse des Anbieters zurückgegeben, die die DbBatch Klasse implementiert.
CreateDbCommand()	Wenn eine abgeleitete Klasse überschrieben wird, wird ein DbCommand Objekt erstellt und zurückgegeben, das der aktuellen Verbindung zugeordnet ist.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Dispose()	Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.
Dispose()	Gibt alle vom Componentverwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom DbConnection verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom Component verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
DisposeAsync()	Das Verbindungsobjekt wird asynchron eingetaucht.
EnlistTransaction(Transaction)	Enlists in der angegebenen Transaktion.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSchema()	Gibt Schemainformationen für die Datenquelle dieses DbConnectionzurück.
GetSchema(String)	Gibt Schemainformationen für die Datenquelle dieses DbConnection mithilfe der angegebenen Zeichenfolge für den Schemanamen zurück.
GetSchema(String, String[])	Gibt Schemainformationen für die Datenquelle dieses DbConnection zurück, wobei die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet wird.
GetSchemaAsync(CancellationToken)	Dies ist eine asynchrone Version von GetSchema(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die `cancellationToken` können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetSchema() Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene `cancellationToken`übergeben wurde. Ausnahmen, die von GetSchema() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.
GetSchemaAsync(String, CancellationToken)	Dies ist die asynchrone Version von GetSchema(String). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die `cancellationToken` können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetSchema(String) Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene `cancellationToken`übergeben wurde. Ausnahmen, die von GetSchema(String) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.
GetSchemaAsync(String, String[], CancellationToken)	Dies ist die asynchrone Version von GetSchema(String, String[]). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die `cancellationToken` können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetSchema(String, String[]) Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene `cancellationToken`übergeben wurde. Ausnahmen, die von GetSchema(String, String[]) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der 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()	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Datenbankverbindung mit den durch die ConnectionStringangegebenen Einstellungen geöffnet.
OpenAsync()	Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den durch die ConnectionStringangegebenen Einstellungen öffnet. 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 geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen Open() Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes cancellationToken übergeben wurde. Ausnahmen, die von Open ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere 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 Componententhält, falls vorhanden. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

Disposed	Tritt auf, wenn die Komponente durch einen 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 und gibt ein DbCommand -Objekt zurück, das der aktuellen Verbindung zugeordnet ist.

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für:

Teilen über