HttpContentHeaderCollection 类

定义

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

public ref class HttpContentHeaderCollection sealed : IIterable<IKeyValuePair<Platform::String ^, Platform::String ^> ^>, IMap<Platform::String ^, Platform::String ^>, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpContentHeaderCollection final : IIterable<IKeyValuePair<winrt::hstring, winrt::hstring const&>>, IMap<winrt::hstring, winrt::hstring const&>, 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpContentHeaderCollection : IDictionary<string,string>, IEnumerable<KeyValuePair<string,string>>, 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
属性
实现
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 具有构造函数,并且由 HttpBufferContentHttpFormUrlEncodedContentHttpMultipartContentHttpMultipartFormDataContentHttpStreamContentHttpStringContent、类和 IHttpContent 接口上的 属性返回。

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

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

构造函数

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

适用于

另请参阅