HttpChallengeHeaderValueCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpChallengeHeaderValueCollection final : 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpChallengeHeaderValueCollection : IEnumerable<HttpChallengeHeaderValue>, IList<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
- Attributs
- Implémente
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. |