HttpContentHeaderCollection 类

定义

命名空间:

Windows.Web.Http.Headers

提供与 HTTP 请求或响应中的内容关联的 HTTP 标头的集合。

public ref class HttpContentHeaderCollection sealed : IIterable<IKeyValuePair<Platform::String ^, Platform::String ^> ^>, IMap<Platform::String ^, Platform::String ^>, 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(65536, "Windows.Foundation.UniversalApiContract")]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, IStringable

function HttpContentHeaderCollection()

Public NotInheritable Class HttpContentHeaderCollection
Implements IDictionary(Of String, String), IEnumerable(Of KeyValuePair(Of String, String)), IStringable

继承

Object Platform::Object IInspectable HttpContentHeaderCollection

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMap<String,String> IDictionary<String,String> IMap<Platform::String,Platform::String> IMap<winrt::hstring,winrt::hstring> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IIterable<IKeyValuePair<String,String>> IEnumerable<KeyValuePair<String,String>> IIterable<IKeyValuePair<Platform::String,Platform::String>> IIterable<IKeyValuePair<winrt::hstring,winrt::hstring>> IStringable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下示例代码演示了使用 HttpContentHeaderCollection 对象上的属性获取和设置 HTTP 内容标头的方法。 Windows.Web.Http.Headers 命名空间具有许多适用于特定 HTTP 标头的强类型标头集合和值类，可用于通过验证获取和设置标头。

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

public void DemonstrateContentHeader()
{
    DemonstrateHeaderContentContentDisposition();
}

public void DemonstrateHeaderContentContentDisposition()
{
    var content = new HttpStringContent("");
    bool parsedOk = false;

    // Set the header with a string.
    HttpContentDispositionHeaderValue value;
    parsedOk = HttpContentDispositionHeaderValue.TryParse("attachment; filename=\"fname.ext\"", out value);
    content.Headers.ContentDisposition = value;

    // Set the header with a strong type.

    content.Headers.ContentDisposition = new HttpContentDispositionHeaderValue("attachment");
    content.Headers.ContentDisposition.FileName = "myfile.exe";


    // Get the strong type out
    System.Diagnostics.Debug.WriteLine("ContentDisposition filename: {0}={1}",
        content.Headers.ContentDisposition.DispositionType,
        content.Headers.ContentDisposition.FileName);

    // The ToString() is useful for diagnostics, too.
    System.Diagnostics.Debug.WriteLine("The ContentDisposition ToString() results: {0}", content.Headers.ContentDisposition.ToString());
}

注解

HttpContentHeaderCollection 是与 HTTP 请求或 HTTP 响应消息上的 HTTP 内容关联的 HTTP 标头的集合。 HttpContentHeaderCollection 对象可用于获取或设置 HTTP 内容上的特定标头。 HttpContentHeaderCollection 对象上的大多数属性都提供对特定 HTTP 标头的容器集合的访问权限。

HttpContentHeaderCollection 具有构造函数，并且由 HttpBufferContent、HttpFormUrlEncodedContent、HttpMultipartContent、HttpMultipartFormDataContent、HttpStreamContent 和 HttpStringContent、类和 IHttpContent 接口上的 属性返回。

枚举 C# 或 Microsoft Visual Basic 中的集合

可以在 C# 或 Microsoft Visual Basic 中循环访问 HttpContentHeaderCollection 对象。 在许多情况下，例如使用 foreach 语法，编译器会为你执行此强制转换，你无需显式转换为 IEnumerable 。 如果需要显式强制转换（例如，如果要调用 GetEnumerator），请将集合对象强制转换为 IEnumerable<T> ，其 KeyValuePair 为 String 和 String 作为约束。

构造函数

HttpContentHeaderCollection()

初始化 HttpContentHeaderCollection 类的新实例。

属性

ContentDisposition	获取或设置 HttpContentDispositionHeaderValue 对象，该对象代表 HTTP 内容上的 HTTP Content-Disposition 标头的值。
ContentEncoding	获取 HttpContentCodingHeaderValue 对象的 HttpContentCodingHeaderValueCollection ，这些对象代表 HTTP 内容上的 HTTP Content-Encoding 标头的值。
ContentLanguage	获取 对象的 HttpLanguageHeaderValueCollection ，这些对象表示 HTTP 内容上的 HTTP 内容语言 标头的值。
ContentLength	获取或设置 HTTP 内容上的 HTTP Content-Length 标头的值。
ContentLocation	获取或设置 HTTP 内容上的 HTTP Content-Location 标头的值。
ContentMD5	获取或设置 HTTP 内容上的 HTTP Content-MD5 标头的值。
ContentRange	获取或设置 HttpContentRangeHeaderValue 对象，该对象代表 HTTP 内容上的 HTTP Content-Range 标头的值。
ContentType	获取或设置 HttpMediaTypeHeaderValue 对象，该对象代表 HTTP 内容上的 HTTP Content-Type 标头的值。
Expires	获取或设置 DateTime 对象，该对象代表 HTTP 内容上的 HTTP Expires 标头的值。
LastModified	获取或设置 DateTime 对象，该对象代表 HTTP 内容上 HTTP Last-Modified 标头的值。
Size	获取 HttpContentHeaderCollection 中的对象数。

方法

Append(String, String)	将新项添加到 HttpContentHeaderCollection 的末尾。
Clear()	从 HttpContentHeaderCollection 中删除所有对象。
First()	检索 HttpContentHeaderCollection 中第一项的迭代器。
GetView()	返回 HttpContentHeaderCollection 的不可变视图。
HasKey(String)	确定 HttpContentHeaderCollection 是否包含指定的键。
Insert(String, String)	使用指定的键和值插入或替换 HttpContentHeaderCollection 中的项。
Lookup(String)	在 HttpContentHeaderCollection 中查找项（如果存在）。
Remove(String)	从 HttpContentHeaderCollection 中删除特定对象。
ToString()	返回表示当前 HttpContentHeaderCollection 对象的字符串。
TryAppendWithoutValidation(String, String)	尝试在未验证的情况下将指定项追加到 HttpContentHeaderCollection 。

另请参阅

• HttpBufferContent
• HttpFormUrlEncodedContent
• HttpMultipartContent
• HttpMultipartFormDataContent
• HttpRequestMessage
• HttpResponseMessage
• HttpStreamContent
• HttpStringContent
• IMap<K,V>
• IIterable<T>
• IStringable