IHttpClientAsyncLogger 介面

定義

命名空間:

Microsoft.Extensions.Http.Logging

組件:

Microsoft.Extensions.Http.dll

套件:

Microsoft.Extensions.Http v9.0.0

來源:

IHttpClientAsyncLogger.cs

IHttpClientFactory所傳回之具名 HttpClient 實例之異步自定義 HTTP 要求記錄的抽象概念。

public interface class IHttpClientAsyncLogger : Microsoft::Extensions::Http::Logging::IHttpClientLogger

public interface IHttpClientAsyncLogger : Microsoft.Extensions.Http.Logging.IHttpClientLogger

type IHttpClientAsyncLogger = interface
    interface IHttpClientLogger

Public Interface IHttpClientAsyncLogger
Implements IHttpClientLogger

實作

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 回應之後記錄。