DbConnection Klasse

Definition

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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, 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, 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
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbConnection
Implements 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
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

Name Beschreibung
DbConnection()

Initialisiert eine neue Instanz der DbConnection-Klasse.

Eigenschaften

Name Beschreibung
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 das, das IContainer die Component.

(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 im 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 dies DbProviderFactoryDbConnectionab.
DesignMode

Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit 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

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
State

Ruft einen Wert ab, der den Status der Verbindung beschreibt.

Methoden

Name Beschreibung
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.
CreateCommand()

Erstellt und gibt ein DbCommand Objekt zurück, das der aktuellen Verbindung zugeordnet ist.
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()

Veröffentlicht alle ressourcen, die von der Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den DbConnection verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von Component)
DisposeAsync()

Entfernt asynchron das Verbindungsobjekt.
EnlistTransaction(Transaction)

Enlists in der angegebenen Transaktion.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetSchema()

Gibt Schemainformationen für die Datenquelle dieses Werts DbConnectionzurück.
GetSchema(String, String[])

Gibt Schemainformationen für die Datenquelle zurück DbConnection , die die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet.
GetSchema(String)

Gibt Schemainformationen für die Datenquelle zurück DbConnection , die die angegebene Zeichenfolge für den Schemanamen verwendet.
GetService(Type)

Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird.

(Geerbt von Component)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()

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 sie in einer abgeleiteten Klasse überschrieben wird, wird eine Datenbankverbindung mit den einstellungen geöffnet, die durch die ConnectionString.
OpenAsync()

Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den einstellungen öffnet, die durch die ConnectionString. 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, wenn die zurückgegebene Aufgabe abgeschlossen ist.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ToString()

Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden.

(Geerbt von Component)

Ereignisse

Name Beschreibung
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

Name Beschreibung
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

Name Beschreibung
ConfigureAwait(IAsyncDisposable, Boolean)

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

Gilt für:

Weitere Informationen