HttpConnectionOptionHeaderValueCollection クラス

定義

HTTP 要求の Connection 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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpConnectionOptionHeaderValueCollection final : 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpConnectionOptionHeaderValueCollection : IEnumerable<HttpConnectionOptionHeaderValue>, IList<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
属性
実装

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 要求の Connection HTTP ヘッダーの値を表します。

HttpConnectionOptionHeaderValueCollection は、HTTP Connection ヘッダーの接続情報に使用される HttpConnectionOptionHeaderValue オブジェクトのコレクションです。

HttpRequestHeaderCollectionConnection プロパティは、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 に追加しようとします。

適用対象

こちらもご覧ください