IHttpClientAsyncLogger インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HttpClientによって返される名前付きIHttpClientFactory インスタンスの非同期カスタム HTTP 要求ログの抽象化。
public interface class IHttpClientAsyncLogger : Microsoft::Extensions::Http::Logging::IHttpClientLoggerpublic interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLoggertype IHttpClientAsyncLogger = interface
interface IHttpClientLoggerPublic Interface IHttpClientAsyncLogger
Implements IHttpClientLogger- 実装
注釈
非同期メソッド ( LogRequestStartAsync(HttpRequestMessage, CancellationToken) など) は非同期コード パス ( SendAsync(HttpRequestMessage, CancellationToken) など) から呼び出され、 IHttpClientLogger から継承された同期メソッド ( LogRequestStart(HttpRequestMessage) など) は、対応する同期コード パスから呼び出されます。
ILoggerを使用するかどうか、または他の何かを使用するかどうか、および正確にログに記録するものを決定するのは、インターフェイスを実装するユーザーの判断です。 ただし、実装では、コンテンツ ストリームからの読み取りなど、 HttpRequestMessage または HttpResponseMessage プロパティの一部にアクセスする場合の潜在的な副作用に注意する必要があります。可能な場合は、このような動作を避ける必要があります。
また、ログの実装では、ログ記録のハンドルされない例外が要求に失敗する可能性があります。例外をスローしないようにする必要があります。
メソッド
| 名前 | 説明 |
|---|---|
| LogRequestFailed(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan) |
HTTP 要求の送信中に発生した例外をログに記録します。 (継承元 IHttpClientLogger) |
| LogRequestFailedAsync(Object, HttpRequestMessage, HttpResponseMessage, Exception, TimeSpan, CancellationToken) |
HTTP 要求の送信中に発生した例外をログに記録します。 |
| LogRequestStart(HttpRequestMessage) |
HTTP 要求を送信する前にログを記録します。 (継承元 IHttpClientLogger) |
| LogRequestStartAsync(HttpRequestMessage, CancellationToken) |
HTTP 要求を送信する前にログを記録します。 |
| LogRequestStop(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan) |
HTTP 応答を受信した後のログ。 (継承元 IHttpClientLogger) |
| LogRequestStopAsync(Object, HttpRequestMessage, HttpResponseMessage, TimeSpan, CancellationToken) |
HTTP 応答を受信した後のログ。 |
