HttpRequestMessage 類別

定義

命名空間:

Windows.Web.Http

表示 HTTP 要求訊息，包括標頭。

public ref class HttpRequestMessage sealed : IClosable, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpRequestMessage final : IClosable, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpRequestMessage : System.IDisposable, IStringable

function HttpRequestMessage(method, uri)

Public NotInheritable Class HttpRequestMessage
Implements IDisposable, IStringable

繼承

Object Platform::Object IInspectable HttpRequestMessage

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable IStringable

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

HttpRequestMessage 類別包含標頭、HTTP 動詞和可能的資料。 此類別通常供需要額外控制 HTTP 要求的開發人員使用。 常見的範例包括：

• 檢查基礎 SSL/TLS 傳輸資訊。
• 若要使用較不常見的 HTTP 方法。
• 若要在 HttpRequestMessage 上明確設定要求屬性。

在這些情況下，應用程式會使用其中一個 HttpRequestMessage 建 構函式來建立 HttpRequestMessage 實例。 應用程式會視需要在 HttpRequestMessage 上設定各種屬性。 然後，HttpRequestMessage 會當做參數傳遞至其中一個 HttpClient.SendRequestAsync 方法。

HttpClient類別上的許多便利方法會自動為應用程式建立 HttpRequestMessage 物件。 這些方法包括下列各項：

• DeleteAsync。
• GetAsync方法。
• GetBufferAsync。
• GetInputStreamAsync。
• GetStringAsync。
• PostAsync。
• PutAsync。

您新增至篩選管線的任何篩選都會傳遞 HttpRequestMessage 物件，無論是由應用程式明確指定，還是為您自動建構。

建構函式

HttpRequestMessage()	初始化 HttpRequestMessage 類別的新實例。
HttpRequestMessage(HttpMethod, Uri)	使用 HTTP 方法和要求URI，初始化HttpRequestMessage類別的新實例。

屬性

Content	取得或設定要傳送至 HttpRequestMessage 物件上伺服器的 HTTP 內容。
Headers	取得與 HttpRequestMessage 相關聯的 HTTP要求標頭集合。
Method	取得或設定要對要求 URI 執行的 HTTP 方法。
PrivacyAnnotation	表示 HTTP 要求訊息，包括標頭。
Properties	取得 HttpRequestMessage 實例上的一組屬性，供開發人員使用。
RequestUri	取得或設定用於HttpRequestMessage物件的Uri。
TransportInformation	取得 HTTP 連線所使用的基礎傳輸通訊端相關資訊。

方法

Close()	關閉 HttpRequestMessage 實例，並釋放已配置的資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
ToString()	會傳回表示目前 HttpRequestMessage 物件的字串。

另請參閱

• HttpClient
• IClosable
• IStringable