DbConnectionInterceptor.ConnectionOpeningAsync メソッド

  • リファレンス

定義

名前空間:
Microsoft.EntityFrameworkCore.Diagnostics
アセンブリ:
Microsoft.EntityFrameworkCore.Relational.dll
パッケージ:
Microsoft.EntityFrameworkCore.Relational v3.0.0
パッケージ:
Microsoft.EntityFrameworkCore.Relational v3.1.0
パッケージ:
Microsoft.EntityFrameworkCore.Relational v5.0.0
パッケージ:
Microsoft.EntityFrameworkCore.Relational v6.0.0
パッケージ:
Microsoft.EntityFrameworkCore.Relational v7.0.0
パッケージ:
Microsoft.EntityFrameworkCore.Relational v8.0.0

EF が を呼び出す直前に呼び出されます OpenAsync()。

public virtual System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult> ConnectionOpeningAsync (System.Data.Common.DbConnection connection, Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData eventData, Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult result, System.Threading.CancellationToken cancellationToken = default);
public virtual System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult> ConnectionOpeningAsync (System.Data.Common.DbConnection connection, Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData eventData, Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult result, System.Threading.CancellationToken cancellationToken = default);
abstract member ConnectionOpeningAsync : System.Data.Common.DbConnection * Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData * Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult>
override this.ConnectionOpeningAsync : System.Data.Common.DbConnection * Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData * Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult>
abstract member ConnectionOpeningAsync : System.Data.Common.DbConnection * Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData * Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult>
override this.ConnectionOpeningAsync : System.Data.Common.DbConnection * Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData * Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult>
Public Overridable Function ConnectionOpeningAsync (connection As DbConnection, eventData As ConnectionEventData, result As InterceptionResult, Optional cancellationToken As CancellationToken = Nothing) As Task(Of InterceptionResult)
Public Overridable Function ConnectionOpeningAsync (connection As DbConnection, eventData As ConnectionEventData, result As InterceptionResult, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of InterceptionResult)

パラメーター

connection
DbConnection

接続。

eventData
ConnectionEventData

接続に関するコンテキスト情報。

result
InterceptionResult

現在の結果が存在する場合は、その結果を表します。 以前のインターセプターで IsSuppressed を呼び出Suppress()して実行が抑制された場合、この値は にtrue設定されます。 この値は、通常、このメソッドの実装の戻り値として使用されます。

cancellationToken
CancellationToken

CancellationTokenタスクの完了を待機している間に観察する 。

戻り値

Task<InterceptionResult>
ValueTask<InterceptionResult>

が false の場合 IsSuppressed 、EF は通常どおり続行されます。 が true の場合 IsSuppressed 、EF は実行しようとしていた操作を抑制します。 操作を抑制しようとしていないインターセプターに対するこのメソッドの通常の実装は、渡された値を result 返すことです。

実装

ConnectionOpeningAsync(DbConnection, ConnectionEventData, InterceptionResult, CancellationToken)

例外

OperationCanceledException

CancellationToken が取り消されている場合。

適用対象