Sprache

RelationalConnection Klasse

Definition

Stellt eine Verbindung mit einer relationalen Datenbank dar.

Dieser Typ wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Sie wird in der Regel nicht im Anwendungscode verwendet.

public abstract class RelationalConnection : IDisposable, Microsoft.EntityFrameworkCore.Storage.IDbContextTransactionManager, Microsoft.EntityFrameworkCore.Storage.IRelationalConnection
[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalConnection : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Storage.IDbContextTransactionManager, Microsoft.EntityFrameworkCore.Storage.IRelationalConnection, Microsoft.EntityFrameworkCore.Storage.ITransactionEnlistmentManager
public abstract class RelationalConnection : IDisposable, Microsoft.EntityFrameworkCore.Storage.IDbContextTransactionManager, Microsoft.EntityFrameworkCore.Storage.IRelationalConnection, Microsoft.EntityFrameworkCore.Storage.ITransactionEnlistmentManager
public abstract class RelationalConnection : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Storage.IDbContextTransactionManager, Microsoft.EntityFrameworkCore.Storage.IRelationalConnection, Microsoft.EntityFrameworkCore.Storage.ITransactionEnlistmentManager
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IDisposable
[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable
    interface ITransactionEnlistmentManager
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IResettableService
    interface IDisposable
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IResettableService
    interface IDisposable
    interface ITransactionEnlistmentManager
type RelationalConnection = class
    interface IRelationalConnection
    interface IRelationalTransactionManager
    interface IDbContextTransactionManager
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable
    interface ITransactionEnlistmentManager
Public MustInherit Class RelationalConnection
Implements IDbContextTransactionManager, IDisposable, IRelationalConnection
Public MustInherit Class RelationalConnection
Implements IAsyncDisposable, IDbContextTransactionManager, IDisposable, IRelationalConnection, ITransactionEnlistmentManager
Public MustInherit Class RelationalConnection
Implements IDbContextTransactionManager, IDisposable, IRelationalConnection, ITransactionEnlistmentManager
Vererbung
RelationalConnection
Attribute
Implementiert

Hinweise

Die Dienstlebensdauer lautet Scoped. Dies bedeutet, dass jede DbContext Instanz eine eigene Instanz dieses Diensts verwendet. Die Implementierung kann von anderen Diensten abhängen, die mit jeder Lebensdauer registriert sind. Die Implementierung muss nicht threadsicher sein.

Weitere Informationen und Beispiele finden Sie unter Implementierung von Datenbankanbietern und Erweiterungen .

Konstruktoren

Name Beschreibung
RelationalConnection(IDbContextOptions, ILogger)

Initialisiert eine neue Instanz der IRelationalConnection-Klasse.

RelationalConnection(RelationalConnectionDependencies)

Initialisiert eine neue Instanz der RelationalConnection-Klasse.

Eigenschaften

Name Beschreibung
ActiveCursor

Dient zum Abrufen oder Festlegen des aktiven Cursors.

CommandTimeout

Ruft das Timeout zum Ausführen eines Befehls für die Datenbank ab.

ConnectionId

Der eindeutige Bezeichner für diese Verbindung.

ConnectionString

Dient zum Abrufen oder Festlegen des Verbindungszeichenfolge für die Datenbank.

Context

Die DbContext aktuell verwendete Datei.

CurrentAmbientTransaction

Die aktuelle Ambient-Transaktion. Wird standardmäßig auf Current festgelegt.

CurrentTransaction

Ruft die aktuelle Transaktion ab.

DbConnection

Dient zum Abrufen oder Festlegen der zugrunde liegenden DbConnection Daten, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden.

Dependencies

Relationale anbieterspezifische Abhängigkeiten für diesen Dienst.

EnlistedTransaction

Die aktuell aufgelistete Transaktion.

IsMultipleActiveResultSetsEnabled

Ruft einen Wert ab, der angibt, ob das Feature für mehrere aktive Resultsets aktiviert ist.

Logger

Ruft den Logger ab, in den geschrieben werden soll.

Semaphore
Veraltet.

Ruft ein Semaphor ab, das zum Serialisieren des Zugriffs auf diese Verbindung verwendet wird.

SupportsAmbientTransactions

Gibt an, ob die Speicherverbindung Umgebungstransaktionen unterstützt.

Methoden

Name Beschreibung
BeginTransaction()

Startet eine neue Transaktion.

BeginTransaction(IsolationLevel)

Startet eine neue Transaktion.

BeginTransactionAsync(CancellationToken)

Beginnt asynchron eine neue Transaktion.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Beginnt asynchron eine neue Transaktion.

Close()

Schließt die Verbindung mit der Datenbank.

CloseAsync()

Schließt die Verbindung mit der Datenbank.

CloseDbConnection()

Vorlagenmethode, die standardmäßig aufruft Close() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

CloseDbConnectionAsync()

Vorlagenmethode, die standardmäßig aufruft CloseAsync() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

CommitTransaction()

Führt einen Commit für alle Änderungen aus, die an der Datenbank in der aktuellen Transaktion vorgenommen wurden.

CommitTransactionAsync(CancellationToken)

Führt einen Commit für alle Änderungen aus, die an der Datenbank in der aktuellen Transaktion vorgenommen wurden.

ConnectionBeginTransaction(IsolationLevel)

Vorlagenmethode, die standardmäßig aufruft BeginDbTransaction(IsolationLevel) , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

ConnectionBeginTransactionAsync(IsolationLevel, CancellationToken)

Vorlagenmethode, die standardmäßig aufruft BeginDbTransactionAsync(IsolationLevel, CancellationToken) , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

ConnectionEnlistTransaction(Transaction)

Vorlagenmethode, die standardmäßig aufruft EnlistTransaction(Transaction) , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

CreateDbConnection()

Erstellt eine DbConnection in der Datenbank.

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

DisposeAsync()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

DisposeDbConnection()

Vorlagenmethode, die standardmäßig aufruft Dispose() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

DisposeDbConnectionAsync()

Vorlagenmethode, die standardmäßig aufruft DisposeAsync() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

EnlistTransaction(Transaction)

Gibt einen vorhandenen Transaction Wert an, der für Datenbankvorgänge verwendet werden soll.

GetValidatedConnectionString()

Gibt die konfigurierte Verbindungszeichenfolge nur zurück, wenn sie festgelegt wurde oder eine gültige DbConnection vorhanden ist.

Open()

Öffnet die Verbindung mit der Datenbank.

Open(Boolean)

Öffnet die Verbindung mit der Datenbank.

OpenAsync(CancellationToken, Boolean)

Öffnet asynchron die Verbindung mit der Datenbank.

OpenAsync(CancellationToken)

Öffnet asynchron die Verbindung mit der Datenbank.

OpenDbConnection(Boolean)

Vorlagenmethode, die standardmäßig aufruft Open() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

OpenDbConnectionAsync(Boolean, CancellationToken)

Vorlagenmethode, die standardmäßig aufruft OpenAsync() , aber von Anbietern überschrieben werden kann, um stattdessen einen anderen Aufruf auszuführen.

RentCommand()

Mietet einen relationalen Befehl, der mit dieser Verbindung ausgeführt werden kann.

ResetState(Boolean)

Setzt den Verbindungsstatus zurück. Aufgerufen von Dispose() und ResetState().

ResetStateAsync(Boolean)

Setzt den Verbindungsstatus zurück. Aufgerufen von DisposeAsync() und ResetStateAsync(CancellationToken).

ReturnCommand(IRelationalCommand)

Gibt einen relationalen Befehl für diese Verbindung zurück, damit er in Zukunft wiederverwendet werden kann.

RollbackTransaction()

Verwirft alle Änderungen, die an der Datenbank in der aktuellen Transaktion vorgenommen wurden.

RollbackTransactionAsync(CancellationToken)

Verwirft alle Änderungen, die an der Datenbank in der aktuellen Transaktion vorgenommen wurden.

SetDbConnection(DbConnection, Boolean)

Legt den zugrunde liegenden DbConnection Wert fest, der zum Herstellen einer Verbindung mit der Datenbank verwendet wird.

UseTransaction(DbTransaction, Guid)

Gibt einen vorhandenen DbTransaction Wert an, der für Datenbankvorgänge verwendet werden soll.

UseTransaction(DbTransaction)

Gibt einen vorhandenen DbTransaction Wert an, der für Datenbankvorgänge verwendet werden soll.

UseTransactionAsync(DbTransaction, CancellationToken)

Gibt einen vorhandenen DbTransaction Wert an, der für Datenbankvorgänge verwendet werden soll.

UseTransactionAsync(DbTransaction, Guid, CancellationToken)

Gibt einen vorhandenen DbTransaction Wert an, der für Datenbankvorgänge verwendet werden soll.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IRelationalConnection.RegisterBufferable(IBufferable)

Registriert eine potenziell pufferbare aktive Abfrage.

IRelationalConnection.RegisterBufferableAsync(IBufferable, CancellationToken)

Registriert asynchron eine potenziell pufferbare aktive Abfrage.

IResettableService.ResetState()

Stellt eine Verbindung mit einer relationalen Datenbank dar.

Dieser Typ wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Sie wird in der Regel nicht im Anwendungscode verwendet.

IResettableService.ResetStateAsync(CancellationToken)

Stellt eine Verbindung mit einer relationalen Datenbank dar.

Dieser Typ wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Sie wird in der Regel nicht im Anwendungscode verwendet.

Gilt für: