HttpMediaTypeWithQualityHeaderValueCollection クラス

  • リファレンス

定義

名前空間:
Windows.Web.Http.Headers
編集

HTTP 要求の Accept HTTP ヘッダーの値を表します。

public ref class HttpMediaTypeWithQualityHeaderValueCollection sealed : IIterable<HttpMediaTypeWithQualityHeaderValue ^>, IVector<HttpMediaTypeWithQualityHeaderValue ^>, 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)]
class HttpMediaTypeWithQualityHeaderValueCollection final : IIterable<HttpMediaTypeWithQualityHeaderValue>, IVector<HttpMediaTypeWithQualityHeaderValue>, IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpMediaTypeWithQualityHeaderValueCollection final : IIterable<HttpMediaTypeWithQualityHeaderValue>, IVector<HttpMediaTypeWithQualityHeaderValue>, 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)]
public sealed class HttpMediaTypeWithQualityHeaderValueCollection : IEnumerable<HttpMediaTypeWithQualityHeaderValue>, IList<HttpMediaTypeWithQualityHeaderValue>, IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpMediaTypeWithQualityHeaderValueCollection : IEnumerable<HttpMediaTypeWithQualityHeaderValue>, IList<HttpMediaTypeWithQualityHeaderValue>, IStringable
Public NotInheritable Class HttpMediaTypeWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpMediaTypeWithQualityHeaderValue), IList(Of HttpMediaTypeWithQualityHeaderValue), IStringable
継承
Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
実装
IIterable<T> IEnumerable<T> IIterable<HttpMediaTypeWithQualityHeaderValue> IEnumerable<HttpMediaTypeWithQualityHeaderValue> IVector<HttpMediaTypeWithQualityHeaderValue> IList<HttpMediaTypeWithQualityHeaderValue> IStringable

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

次のサンプル コードは、HttpMediaTypeWithQualityHeaderValueCollection クラスおよび HttpMediaTypeWithQualityHeaderValue クラスのプロパティとメソッドを使用して、HttpRequestMessage オブジェクトの Accept HTTP ヘッダーを取得および設定するメソッドを示しています。

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.2");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.4; mysetting=myvalue");

            // Set the header with a strong type.
            request.Headers.Accept.Add(new HttpMediaTypeWithQualityHeaderValue("audio/*", .6));

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

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

注釈

HttpMediaTypeWithQualityHeaderValueCollection は、HTTP 要求の Accept HTTP ヘッダーの値を表します。

HttpMediaTypeWithQualityHeaderValueCollection は、HTTP Accept ヘッダーの情報を受け入れるために使用される HttpMediaTypeWithQualityHeaderValue オブジェクトのコレクションです。

HttpRequestHeaderCollection の Accept プロパティは、HttpMediaTypeWithQualityHeaderValueCollection オブジェクトを返します。

プロパティ

Size

コレクション内の HttpMediaTypeWithQualityHeaderValue オブジェクトの数を取得します。

メソッド

Append(HttpMediaTypeWithQualityHeaderValue)

新しい HttpMediaTypeWithQualityHeaderValue 項目をコレクションの末尾に追加します。
Clear()

コレクションからすべてのオブジェクトを削除します。
First()

コレクション内の最初の HttpMediaTypeWithQualityHeaderValue 項目を指す反復子を取得します。
GetAt(UInt32)

コレクション内の指定したインデックス位置にある HttpMediaTypeWithQualityHeaderValue を返します。
GetMany(UInt32, HttpMediaTypeWithQualityHeaderValue[])

コレクション内の指定したインデックスから始まる HttpMediaTypeWithQualityHeaderValue 項目を取得します。
GetView()

HttpMediaTypeWithQualityHeaderValueCollection の変更できないビューを返します。
IndexOf(HttpMediaTypeWithQualityHeaderValue, UInt32)

コレクション内の HttpMediaTypeWithQualityHeaderValue のインデックスを取得します。
InsertAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

指定したインデックス位置にあるコレクションに HttpMediaTypeWithQualityHeaderValue を挿入します。
ParseAdd(String)

HttpMediaTypeWithQualityHeaderValueCollection にエントリを解析して追加します。
RemoveAt(UInt32)

指定したインデックス位置にあるエントリを HttpMediaTypeWithQualityHeaderValueCollection から削除します。
RemoveAtEnd()

コレクションから最後の HttpMediaTypeWithQualityHeaderValue 項目を削除します。
ReplaceAll(HttpMediaTypeWithQualityHeaderValue[])

コレクション内のすべての HttpMediaTypeWithQualityHeaderValue 項目を、指定した HttpMediaTypeWithQualityHeaderValue 項目に置き換えます。
SetAt(UInt32, HttpMediaTypeWithQualityHeaderValue)

コレクション内の指定したインデックスに HttpMediaTypeWithQualityHeaderValue を設定します。
ToString()

現在の HttpMediaTypeWithQualityHeaderValueCollection オブジェクトを表す文字列を返します。
TryParseAdd(String)

指定した項目を解析し、 HttpMediaTypeWithQualityHeaderValueCollection に追加しようとします。

適用対象

こちらもご覧ください