HttpChallengeHeaderValueCollection Classe

Definição

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
Object Platform::Object IInspectable HttpChallengeHeaderValueCollection
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.

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.

Aplica-se a

Confira também