HttpMessageHandler 類別

定義

命名空間:

System.Net.Http

組件:

netstandard.dll, System.Net.Http.dll

來源:

HttpMessageHandler.cs

HTTP 訊息處理程式的基底類型。

public ref class HttpMessageHandler abstract : IDisposable

public abstract class HttpMessageHandler : IDisposable

type HttpMessageHandler = class
    interface IDisposable

Public MustInherit Class HttpMessageHandler
Implements IDisposable

繼承

Object

HttpMessageHandler

衍生

System.Net.Http.DelegatingHandler

System.Net.Http.HttpClientHandler

System.Net.Http.SocketsHttpHandler

System.Net.Http.WinHttpHandler

實作

IDisposable

備註

有各種 HTTP 訊息處理程式可用。 這些包括以下幾項。

1. DelegatingHandler - 一個用來將處理器插入處理器鏈的類別。

2. HttpMessageHandler - 一個簡單的類，可從中推導，支援大多數應用中最常見的需求。

3. HttpClientHandler - 一個在處理程序鏈底部操作的類別，實際處理 HTTP 傳輸操作。

4. WebRequestHandler - 一個專門類別，運作於處理鏈類別底部，負責 HTTP 傳輸操作，並有針對該 System.Net.HttpWebRequest 物件的選項。

如果開發者從 HttpMessageHandler 該方法衍生出類別並覆寫 SendAsync 該方法，必須確保不同執行緒能同時呼叫該 SendAsync 類別。

這是必要的，因為 上 HttpClient 的方法可以同時呼叫，且需要執行緒安全保證。 因此，如果一個處理器被指派到一個 HttpClient 實例， SendAsync 該處理器的方法可能會被 HttpClient 該實例同時呼叫，且必須保持執行緒安全。

建構函式

名稱	Description
HttpMessageHandler()	初始化 HttpMessageHandler 類別的新執行個體。

方法

名稱	Description
Dispose()	釋放未管理的資源並處理由 HttpMessageHandler.
Dispose(Boolean)	釋放未管理的資源， HttpMessageHandler 並可選擇性地處置這些受管理資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
Send(HttpRequestMessage, CancellationToken)	當在派生類別中被覆寫時，會發送帶有指定請求與取消標記的 HTTP 請求。 否則，會拋出 NotSupportedException。
SendAsync(HttpRequestMessage, CancellationToken)	以非同步操作方式發送 HTTP 請求。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)