HttpContentHeaderCollection 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供与 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
- 继承
- 属性
- 实现
-
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 。 |