HttpChallengeHeaderValueCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

Représente la valeur de l’en-tête HTTP Proxy-Authenticate ou WWW-Authenticate sur une réponse 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

Héritage

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de code suivant montre une méthode permettant d’obtenir et de définir l’en-tête HTTP Proxy-Authenticate sur un objet HttpResponseMessage à l’aide des propriétés et méthodes des classes HttpChallengeHeaderValueCollection et HttpChallengeHeaderValue .

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());
        }

Remarques

HttpChallengeHeaderValueCollection représente la valeur de l’en-tête HTTP Proxy-Authenticate ou WWW-Authenticate sur une réponse HTTP.

HttpChallengeHeaderValueCollection fournit un conteneur de collection pour les instances de la classe HttpChallengeHeaderValue utilisée pour les informations d’authentification utilisées dans les valeurs d’en-tête HTTP Authorization, ProxyAuthorization, WWW-Authenticate et Proxy-Authenticate .

La propriété ProxyAuthenticate sur HttpResponseHeaderCollection renvoie un objet HttpChallengeHeaderValueCollection. La propriété WwwAuthenticate sur HttpResponseHeaderCollection renvoie également un objet HttpChallengeHeaderValueCollection.

Listes de membres de la collection

Pour JavaScript, HttpChallengeHeaderValueCollection contient les membres affichés dans les listes de membres. En outre, HttpChallengeHeaderValueCollection prend en charge les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

Vous pouvez itérer au sein d’un objet HttpChallengeHeaderValueCollection en C# ou Microsoft Visual Basic. Dans de nombreux cas, comme l’utilisation de la syntaxe foreach , le compilateur effectue ce cast pour vous et vous n’aurez pas besoin d’effectuer un cast IEnumerable<HttpChallengeHeaderValue> vers explicitement. Si vous devez effectuer un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, castez l’objet de collection en IEnumerable<T> avec une contrainte HttpChallengeHeaderValue .

Propriétés

Size	Obtient le nombre d’objets HttpChallengeHeaderValue dans la collection.

Méthodes

Append(HttpChallengeHeaderValue)	Ajoute un nouvel élément HttpChallengeHeaderValue à la fin de la collection.
Clear()	Supprime tous les objets HttpChallengeHeaderValue de la collection.
First()	Récupère un itérateur vers le premier élément HttpChallengeHeaderValue de la collection.
GetAt(UInt32)	Renvoie la valeur HttpChallengeHeaderValue à l’index spécifié dans la collection.
GetMany(UInt32, HttpChallengeHeaderValue[])	Récupère les éléments HttpChallengeHeaderValue qui commencent à l’index spécifié dans la collection.
GetView()	Renvoie une vue immuable de HttpChallengeHeaderValueCollection.
IndexOf(HttpChallengeHeaderValue, UInt32)	Récupère l’index d’un objet HttpChallengeHeaderValue dans la collection.
InsertAt(UInt32, HttpChallengeHeaderValue)	Insère une valeur HttpChallengeHeaderValue dans la collection à l’index spécifié.
ParseAdd(String)	Analyse et ajoute une entrée à httpChallengeHeaderValueCollection.
RemoveAt(UInt32)	Supprime l’entrée à l’index spécifié de l’objet HttpChallengeHeaderValueCollection.
RemoveAtEnd()	Supprime le dernier élément HttpChallengeHeaderValue de la collection.
ReplaceAll(HttpChallengeHeaderValue[])	Remplace tous les éléments HttpChallengeHeaderValue de la collection par les éléments HttpChallengeHeaderValue spécifiés.
SetAt(UInt32, HttpChallengeHeaderValue)	Définit la valeur HttpChallengeHeaderValue à l’index spécifié dans la collection.
ToString()	Renvoie une chaîne qui représente l’objet HttpChallengeHeaderValueCollection actuel.
TryParseAdd(String)	Tente d’analyser et d’ajouter l’élément spécifié à httpChallengeHeaderValueCollection.

Voir aussi

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