HttpMessageHandler 類別

定義

命名空間:

System.Net.Http

組件:

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 實例同時呼叫，而且必須是安全線程。

建構函式

HttpMessageHandler()

初始化 HttpMessageHandler 類別的新執行個體。

方法

Dispose()	釋放 Unmanaged 資源，並處置 HttpMessageHandler 所使用的 Managed 資源。
Dispose(Boolean)	釋放 HttpMessageHandler 所使用的 Unmanaged 資源，並選擇性處置 Managed 資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Send(HttpRequestMessage, CancellationToken)	在衍生類別中遭到覆寫時，使用指定的要求和取消語彙基元來傳送 HTTP 要求。 否則，擲回 NotSupportedException。
SendAsync(HttpRequestMessage, CancellationToken)	以非同步作業的方式，傳送 HTTP 要求。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)