HttpChallengeHeaderValueCollection クラス

定義

名前空間:

Windows.Web.Http.Headers

HTTP 応答の Proxy-Authenticate または WWW-Authenticate HTTP ヘッダーの値を表します。

public ref class HttpChallengeHeaderValueCollection sealed : IIterable<HttpChallengeHeaderValue ^>, IVector<HttpChallengeHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpChallengeHeaderValueCollection
Implements IEnumerable(Of HttpChallengeHeaderValue), IList(Of HttpChallengeHeaderValue), IStringable

継承

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

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

Windows の要件

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

例

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

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

        public void DemonstrateHeaderResponseProxyAuthenticate() {
            var response = new HttpResponseMessage();

            // Set the header with a strong type.
            response.Headers.ProxyAuthenticate.TryParseAdd("Basic");
            response.Headers.ProxyAuthenticate.Add(new HttpChallengeHeaderValue("authScheme", "authToken"));

            // Get the strong type out
            foreach (var value in response.Headers.ProxyAuthenticate) {
                System.Diagnostics.Debug.WriteLine("Proxy authenticate scheme and token: {0} {1}", value.Scheme, value.Token);
            }

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

注釈

HttpChallengeHeaderValueCollection は、HTTP 応答の Proxy-Authenticate または WWW-Authenticate HTTP ヘッダーの値を表します。

HttpChallengeHeaderValueCollection は、Authorization、ProxyAuthorization、WWW-Authenticate、および Proxy-Authenticate HTTP ヘッダー値で使用される認証情報に使用される HttpChallengeHeaderValue クラスのインスタンス用のコレクション コンテナーを提供します。

HttpResponseHeaderCollection の ProxyAuthenticate プロパティは、HttpChallengeHeaderValueCollection オブジェクトを返します。 HttpResponseHeaderCollection の WwwAuthenticate プロパティは、HttpChallengeHeaderValueCollection オブジェクトも返します。

コレクション メンバー リスト

JavaScript の場合、HttpChallengeHeaderValueCollection にはメンバー リストにメンバーが表示されます。 さらに、HttpChallengeHeaderValueCollection では 、Array.prototype のメンバーと、インデックスを使用して項目にアクセスできます。

C# または Microsoft Visual Basic でのコレクションの列挙

C# または Microsoft Visual Basic で HttpChallengeHeaderValueCollection オブジェクトを反復処理できます。 foreach 構文の使用など、多くの場合、コンパイラによってこのキャストが行われ、明示的に キャストするIEnumerable<HttpChallengeHeaderValue>必要はありません。 GetEnumerator を呼び出す場合など、明示的にキャストする必要がある場合は、HttpChallengeHeaderValue 制約を使用してコレクション オブジェクトを IEnumerable<T> にキャストします。

プロパティ

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

メソッド

Append(HttpChallengeHeaderValue)	新しい HttpChallengeHeaderValue 項目をコレクションの末尾に追加します。
Clear()	コレクションからすべての HttpChallengeHeaderValue オブジェクトを削除します。
First()	コレクション内の最初の HttpChallengeHeaderValue 項目を指す反復子を取得します。
GetAt(UInt32)	コレクション内の指定したインデックス位置にある HttpChallengeHeaderValue を返します。
GetMany(UInt32, HttpChallengeHeaderValue[])	コレクション内の指定したインデックスから始まる HttpChallengeHeaderValue 項目を取得します。
GetView()	HttpChallengeHeaderValueCollection の変更できないビューを返します。
IndexOf(HttpChallengeHeaderValue, UInt32)	コレクション内の HttpChallengeHeaderValue のインデックスを取得します。
InsertAt(UInt32, HttpChallengeHeaderValue)	指定したインデックス位置にあるコレクションに HttpChallengeHeaderValue を挿入します。
ParseAdd(String)	HttpChallengeHeaderValueCollection にエントリを解析して追加します。
RemoveAt(UInt32)	指定したインデックス位置にあるエントリを HttpChallengeHeaderValueCollection から削除します。
RemoveAtEnd()	コレクションから最後の HttpChallengeHeaderValue 項目を削除します。
ReplaceAll(HttpChallengeHeaderValue[])	コレクション内のすべての HttpChallengeHeaderValue 項目を、指定した HttpChallengeHeaderValue 項目に置き換えます。
SetAt(UInt32, HttpChallengeHeaderValue)	コレクション内の指定したインデックス位置に HttpChallengeHeaderValue を設定します。
ToString()	現在の HttpChallengeHeaderValueCollection オブジェクトを表す文字列を返します。
TryParseAdd(String)	指定した項目を解析して HttpChallengeHeaderValueCollection に追加しようとします。

こちらもご覧ください

• HttpChallengeHeaderValue
• HttpResponseMessage
• HttpResponseHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• ProxyAuthenticate
• WwwAuthenticate