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-AgentHTTP ヘッダーを取得および設定するメソッドを示しています。

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 は、HTTP User-Agent ヘッダーの製品情報に使用される HttpProductInfoHeaderValue オブジェクトのコレクションです。

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