HttpContentDispositionHeaderValue 類別

定義

命名空間:

Windows.Web.Http.Headers

表示要求或回應中 HTTP 內容上 Content-Disposition HTTP 標頭的值。

public ref class HttpContentDispositionHeaderValue sealed : 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.Headers.IHttpContentDispositionHeaderValueFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpContentDispositionHeaderValue final : 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.Headers.IHttpContentDispositionHeaderValueFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpContentDispositionHeaderValue : IStringable

function HttpContentDispositionHeaderValue(dispositionType)

Public NotInheritable Class HttpContentDispositionHeaderValue
Implements IStringable

繼承

Object Platform::Object IInspectable HttpContentDispositionHeaderValue

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IStringable

Windows 需求

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

範例

請參閱 HttpContentHeaderCollection 類別中的程式碼範例。

備註

HttpContentDispositionHeaderValue 類別代表 HTTP 要求中傳送或 HTTP 回應中接收之 HTTP 內容之 Content-Disposition 標頭中的資訊。

HttpContentHeaderCollection上的ContentDisposition屬性會傳回 HttpContentDispositionHeaderValue。

Content-Disposition標頭通常用來處理檔案上傳和下載。 格式與其他標頭不同，因為它是具有處置類型的單一標頭，後面接著參數清單，其中有些已妥善定義。

此標頭用於兩個不同的內容：

• HttpMultipartFormDataContent類別中巢狀本文內容的 MIME 標頭。 如需詳細資訊，請參閱 IETF RFC 2183。
• HttpContentHeaderCollection類別中的 HTTP 標頭。 如需詳細資訊，請參閱 IETF RFC 6266。

建構函式

HttpContentDispositionHeaderValue(String)

使用內容編碼資訊，初始化HttpContentDispositionHeaderValue類別的新實例，以用於Content-Disposition HTTP 標頭。

屬性

DispositionType	取得或設定Content-Disposition HTTP 標頭中處置類型資訊的值。
FileName	取得或設定單一檔案之 Content-Disposition HTTP 標頭中filename-parm資訊的值。
FileNameStar	取得或設定多個檔案之 Content-Disposition HTTP 標頭中filename-parm特性的值。
Name	取得或設定 Content-Disposition HTTP 標頭中內容本文元件的名稱。
Parameters	取得 Content-Disposition HTTP 標頭中包含的一組參數。
Size	取得或設定 Content-Disposition HTTP 標頭中所使用檔案的近似大小，以位元組為單位。

方法

Parse(String)	將字串轉換成 HttpContentDispositionHeaderValue 實例。
ToString()	會傳回字串，表示目前的 HttpContentDispositionHeaderValue 物件。
TryParse(String, HttpContentDispositionHeaderValue)	判斷字串是否有效 HttpContentDispositionHeaderValue 資訊。

另請參閱

• ContentDisposition
• HttpContentHeaderCollection
• IStringable