IHttpClientAsyncLogger 介面

定義

命名空間:

Microsoft.Extensions.Http.Logging

組件:

Microsoft.Extensions.Http.dll

套件:

Microsoft.Extensions.Http v9.0.0-preview.3.24172.9

來源:

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