HttpProductInfoHeaderValueCollection 类

定义

命名空间:

Windows.Web.Http.Headers

表示 HTTP 请求上的 User-Agent HTTP 标头的值。

public ref class HttpProductInfoHeaderValueCollection sealed : IIterable<HttpProductInfoHeaderValue ^>, IVector<HttpProductInfoHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpProductInfoHeaderValueCollection
Implements IEnumerable(Of HttpProductInfoHeaderValue), IList(Of HttpProductInfoHeaderValue), IStringable

继承

Object Platform::Object IInspectable HttpProductInfoHeaderValueCollection

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

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

Windows 要求

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

示例

以下示例代码演示了一个方法，该方法使用 HttpProductInfoHeaderValueCollection 和 HttpProductInfoHeaderValue 类的属性和方法在 HttpRequestMessage 对象上获取和设置 User-Agent HTTP 标头。

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

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

            // Set the header with a string.
            parsedOk = request.Headers.UserAgent.TryParseAdd("testprogram/1.0");

            // Set the header with a strong type.
            request.Headers.UserAgent.Add(new HttpProductInfoHeaderValue("myprogram", "2.2"));

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

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

注解

HttpProductInfoHeaderValueCollection 表示 HTTP 请求上的 User-Agent HTTP 标头的值。

HttpProductInfoHeaderValueCollection 是 HttpProductInfoHeaderValue 对象的集合，用于 HTTP User-Agent 标头中的产品信息。

User-Agent 标头包含有关发起请求的用户代理的信息。 User-Agent 标头可以包含多个产品令牌和注释，用于标识用户代理和任何子产品。

HttpRequestHeaderCollection 上的 UserAgent 属性返回 HttpProductInfoHeaderValueCollection 对象。

属性

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

方法

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

另请参阅

• HttpProductInfoHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• UserAgent