HttpConnectionOptionHeaderValueCollection 类

定义

命名空间:

Windows.Web.Http.Headers

表示 HTTP 请求上的 连接 HTTP 标头的值。

public ref class HttpConnectionOptionHeaderValueCollection sealed : IIterable<HttpConnectionOptionHeaderValue ^>, IVector<HttpConnectionOptionHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpConnectionOptionHeaderValueCollection
Implements IEnumerable(Of HttpConnectionOptionHeaderValue), IList(Of HttpConnectionOptionHeaderValue), IStringable

继承

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

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

Windows 要求

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

示例

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

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Connection.TryParseAdd("close");

            // Set the header with a strong type.
            request.Headers.Connection.Add(new HttpConnectionOptionHeaderValue("cache-control"));

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

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

注解

HttpConnectionOptionHeaderValueCollection 表示 HTTP 请求上的 连接 HTTP 标头的值。

HttpConnectionOptionHeaderValueCollection 是 HttpConnectionOptionHeaderValue 对象的集合，用于 HTTP 连接 标头上的连接信息。

HttpRequestHeaderCollection 上的 Connection 属性返回 HttpConnectionOptionHeaderValueCollection 对象。

集合成员列表

对于 JavaScript，HttpConnectionOptionHeaderValueCollection 的成员显示在成员列表中。 此外，HttpConnectionOptionHeaderValueCollection 支持 Array.prototype 的成员，并使用索引访问项。

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

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

属性

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

方法

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

另请参阅

• Connection
• HttpConnectionOptionHeaderValue
• HttpRequestHeaderCollection
• HttpRequestMessage
• IIterable<T>
• IStringable
• IVector<T>