HttpChallengeHeaderValueCollection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o valor do cabeçalho HTTP Proxy-Authenticate ou WWW-Authenticate em uma resposta 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
- Herança
- Atributos
- Implementações
Requisitos do Windows
Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
O código de exemplo a seguir mostra um método para obter e definir o cabeçalho HTTP Proxy-Authenticate em um objeto HttpResponseMessage usando as propriedades e métodos nas classes HttpChallengeHeaderValueCollection e 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());
}
Comentários
O HttpChallengeHeaderValueCollection representa o valor do cabeçalho HTTP Proxy-Authenticate ou WWW-Authenticate em uma resposta HTTP.
O HttpChallengeHeaderValueCollection fornece um contêiner de coleção para instâncias da classe HttpChallengeHeaderValue usada para informações de autenticação usadas nos valores de cabeçalho HTTP Authorization, ProxyAuthorization, WWW-Authenticate e Proxy-Authenticate .
A propriedade ProxyAuthenticate em HttpResponseHeaderCollection retorna um objeto HttpChallengeHeaderValueCollection. A propriedade WwwAuthenticate em HttpResponseHeaderCollection também retorna um objeto HttpChallengeHeaderValueCollection.
Listas de membros da coleção
Para JavaScript, HttpChallengeHeaderValueCollection tem os membros mostrados nas listas de membros. Além disso, HttpChallengeHeaderValueCollection dá suporte a membros de Array.prototype e ao uso de um índice para acessar itens.
Enumerando a coleção em C# ou Microsoft Visual Basic
Você pode iterar por meio de um objeto HttpChallengeHeaderValueCollection em C# ou Microsoft Visual Basic. Em muitos casos, como o uso da sintaxe foreach , o compilador faz essa conversão para você e você não precisará converter IEnumerable<HttpChallengeHeaderValue>
explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta o objeto de coleção para IEnumerable<T> com uma restrição HttpChallengeHeaderValue .
Propriedades
Size |
Obtém o número de objetos HttpChallengeHeaderValue na coleção. |