IHttpClientAsyncLogger インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
IHttpClientFactoryによって返される名前付き HttpClient インスタンスの非同期カスタム 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 応答を受信した後のログ。 |
適用対象
.NET