HttpCookiePairHeaderValueCollection 类

定义

命名空间:

Windows.Web.Http.Headers

表示 HTTP 请求上的 Cookie HTTP 标头的值。

public ref class HttpCookiePairHeaderValueCollection sealed : IIterable<HttpCookiePairHeaderValue ^>, IVector<HttpCookiePairHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpCookiePairHeaderValueCollection final : IIterable<HttpCookiePairHeaderValue>, IVector<HttpCookiePairHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpCookiePairHeaderValueCollection : IEnumerable<HttpCookiePairHeaderValue>, IList<HttpCookiePairHeaderValue>, IStringable

Public NotInheritable Class HttpCookiePairHeaderValueCollection
Implements IEnumerable(Of HttpCookiePairHeaderValue), IList(Of HttpCookiePairHeaderValue), IStringable

继承

Object Platform::Object IInspectable HttpCookiePairHeaderValueCollection

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

IIterable<T> IEnumerable<T> IIterable<HttpCookiePairHeaderValue> IEnumerable<HttpCookiePairHeaderValue> IVector<HttpCookiePairHeaderValue> IList<HttpCookiePairHeaderValue> IStringable

Windows 要求

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

示例

以下示例代码演示了一个方法，该方法使用 HttpCookiePairHeaderValueCollection 和 HttpCookiePairHeaderValue 类的属性和方法获取和设置 HttpRequestMessage 对象上的 Cookie HTTP 标头。

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

        public void DemonstrateHeaderRequestCookie() {
            var request = new HttpRequestMessage();
            bool parsedOk = false;

            // Set the header with a string.
            parsedOk = request.Headers.Cookie.TryParseAdd("cookieName=cookieValue");

            // Set the header with a strong type.
            request.Headers.Cookie.Add(new HttpCookiePairHeaderValue("cookie2", "value2"));

            // Get the strong type out
            foreach (var value in request.Headers.Cookie) {
                System.Diagnostics.Debug.WriteLine("One of the Cookie values: {0}={1}", value.Name, value.Value);
            }

注解

HttpCookiePairHeaderValueCollection 类表示 HTTP 请求上的 Cookie HTTP 标头的值。

HttpCookiePairHeaderValueCollection 为用于 Cookie HTTP 标头中的 Cookie 信息的 HttpCookiePairHeaderValue 类的实例提供收集容器。

HttpRequestHeaderCollection 上的 Cookie 属性返回 HttpCookiePairHeaderValueCollection 对象

属性

Size	获取集合中 HttpCookiePairHeaderValue 对象的数目。

方法

Append(HttpCookiePairHeaderValue)	将新的 HttpCookiePairHeaderValue 项添加到集合的末尾。
Clear()	从集合中删除所有对象。
First()	检索集合中第一个 HttpCookiePairHeaderValue 项的迭代器。
GetAt(UInt32)	返回集合中指定索引处的 HttpCookiePairHeaderValue 。
GetMany(UInt32, HttpCookiePairHeaderValue[])	检索从集合中的指定索引处开始的 HttpCookiePairHeaderValue 项。
GetView()	返回 HttpCookiePairHeaderValueCollection 的不可变视图。
IndexOf(HttpCookiePairHeaderValue, UInt32)	检索集合中 HttpCookiePairHeaderValue 的索引。
InsertAt(UInt32, HttpCookiePairHeaderValue)	将 HttpCookiePairHeaderValue 插入集合中的指定索引处。
ParseAdd(String)	分析 HttpCookiePairHeaderValueCollection 并添加一个条目。
RemoveAt(UInt32)	从 HttpCookiePairHeaderValueCollection 中删除指定索引处的条目。
RemoveAtEnd()	从集合中删除最后一个 HttpCookiePairHeaderValue 项。
ReplaceAll(HttpCookiePairHeaderValue[])	将集合中的所有 HttpCookiePairHeaderValue 项替换为指定的 HttpCookiePairHeaderValue 项。
SetAt(UInt32, HttpCookiePairHeaderValue)	设置集合中指定索引处的 HttpCookiePairHeaderValue 。
ToString()	返回表示当前 HttpCookiePairHeaderValueCollection 对象的字符串。
TryParseAdd(String)	尝试分析指定项并将其添加到 HttpCookiePairHeaderValueCollection。

另请参阅

• IVector<T>
• IIterable<T>
• IStringable