HttpChallengeHeaderValueCollection Clase

Definición

Espacio de nombres:

Windows.Web.Http.Headers

Representa el valor del encabezado HTTP Proxy-Authenticate o WWW-Authenticate en una respuesta 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

Herencia

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

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

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El código de ejemplo siguiente muestra un método para obtener y establecer el encabezado HTTP Proxy-Authenticate en un objeto HttpResponseMessage mediante las propiedades y métodos de las clases HttpChallengeHeaderValueCollection y 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());
        }

Comentarios

HttpChallengeHeaderValueCollection representa el valor del encabezado HTTP Proxy-Authenticate o WWW-Authenticate en una respuesta HTTP.

HttpChallengeHeaderValueCollection proporciona un contenedor de colecciones para instancias de la clase HttpChallengeHeaderValue usada para la información de autenticación utilizada en los valores de encabezado HTTP Authorization, ProxyAuthorization, WWW-Authenticate y Proxy-Authenticate HTTP.

La propiedad ProxyAuthenticate en HttpResponseHeaderCollection devuelve un objeto HttpChallengeHeaderValueCollection. La propiedad WwwAuthenticate en HttpResponseHeaderCollection también devuelve un objeto HttpChallengeHeaderValueCollection.

Listas de miembros de la colección

Para JavaScript, HttpChallengeHeaderValueCollection tiene los miembros que se muestran en las listas de miembros. Además, HttpChallengeHeaderValueCollection admite miembros de Array.prototype y el uso de un índice para acceder a los elementos.

Enumeración de la colección en C# o Microsoft Visual Basic

Puede recorrer en iteración un objeto HttpChallengeHeaderValueCollection en C# o Microsoft Visual Basic. En muchos casos, como el uso de la sintaxis foreach , el compilador realiza esta conversión por usted y no tendrá que convertir a IEnumerable<HttpChallengeHeaderValue> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta el objeto de colección en IEnumerable<T> con una restricción HttpChallengeHeaderValue .

Propiedades

Size	Obtiene el número de objetos HttpChallengeHeaderValue de la colección.

Métodos

Append(HttpChallengeHeaderValue)	Agrega un nuevo elemento HttpChallengeHeaderValue al final de la colección.
Clear()	Quita todos los objetos HttpChallengeHeaderValue de la colección.
First()	Recupera un iterador en el primer elemento HttpChallengeHeaderValue de la colección.
GetAt(UInt32)	Devuelve httpChallengeHeaderValue en el índice especificado de la colección.
GetMany(UInt32, HttpChallengeHeaderValue[])	Recupera los elementos HttpChallengeHeaderValue que comienzan en el índice especificado de la colección.
GetView()	Devuelve una vista inmutable de HttpChallengeHeaderValueCollection.
IndexOf(HttpChallengeHeaderValue, UInt32)	Recupera el índice de httpChallengeHeaderValue en la colección.
InsertAt(UInt32, HttpChallengeHeaderValue)	Inserta httpChallengeHeaderValue en la colección en el índice especificado.
ParseAdd(String)	Analiza y agrega una entrada a HttpChallengeHeaderValueCollection.
RemoveAt(UInt32)	Quita la entrada en el índice especificado de HttpChallengeHeaderValueCollection.
RemoveAtEnd()	Quita el último elemento HttpChallengeHeaderValue de la colección.
ReplaceAll(HttpChallengeHeaderValue[])	Reemplaza todos los elementos HttpChallengeHeaderValue de la colección por los elementos HttpChallengeHeaderValue especificados.
SetAt(UInt32, HttpChallengeHeaderValue)	Establece HttpChallengeHeaderValue en el índice especificado de la colección.
ToString()	Devuelve una cadena que representa el objeto HttpChallengeHeaderValueCollection actual.
TryParseAdd(String)	Intenta analizar y agregar el elemento especificado a httpChallengeHeaderValueCollection.

Consulte también

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