HttpChallengeHeaderValueCollection Classe

Definição

Namespace:

Windows.Web.Http.Headers

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)]
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

Herança

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

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

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.

Métodos

Append(HttpChallengeHeaderValue)	Adiciona um novo item HttpChallengeHeaderValue ao final da coleção.
Clear()	Remove todos os objetos HttpChallengeHeaderValue da coleção.
First()	Recupera um iterador para o primeiro item HttpChallengeHeaderValue na coleção.
GetAt(UInt32)	Retorna o HttpChallengeHeaderValue no índice especificado na coleção.
GetMany(UInt32, HttpChallengeHeaderValue[])	Recupera os itens HttpChallengeHeaderValue que começam no índice especificado na coleção.
GetView()	Retorna uma exibição imutável do HttpChallengeHeaderValueCollection.
IndexOf(HttpChallengeHeaderValue, UInt32)	Recupera o índice de um HttpChallengeHeaderValue na coleção.
InsertAt(UInt32, HttpChallengeHeaderValue)	Insere um HttpChallengeHeaderValue na coleção no índice especificado.
ParseAdd(String)	Analisa e adiciona uma entrada ao HttpChallengeHeaderValueCollection.
RemoveAt(UInt32)	Remove a entrada no índice especificado do HttpChallengeHeaderValueCollection.
RemoveAtEnd()	Remove o último item HttpChallengeHeaderValue da coleção.
ReplaceAll(HttpChallengeHeaderValue[])	Substitui todos os itens HttpChallengeHeaderValue na coleção pelos itens HttpChallengeHeaderValue especificados.
SetAt(UInt32, HttpChallengeHeaderValue)	Define o HttpChallengeHeaderValue no índice especificado na coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto HttpChallengeHeaderValueCollection atual.
TryParseAdd(String)	Tenta analisar e adicionar o item especificado ao HttpChallengeHeaderValueCollection.

Confira também

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