HttpChallengeHeaderValueCollection Classe

Definizione

Spazio dei nomi:

Windows.Web.Http.Headers

Rappresenta il valore dell'intestazione HTTP Proxy-Authenticate o WWW-Authenticate su una risposta 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

Ereditarietà

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il codice di esempio seguente illustra un metodo per ottenere e impostare l'intestazione HTTP Proxy-Authenticate in un oggetto HttpResponseMessage usando le proprietà e i metodi nelle classi 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());
        }

Commenti

HttpChallengeHeaderValueCollection rappresenta il valore dell'intestazione HTTP Proxy-Authenticate o WWW-Authenticate su una risposta HTTP.

HttpChallengeHeaderValueCollection fornisce un contenitore di raccolta per le istanze della classe HttpChallengeHeaderValue utilizzata per le informazioni di autenticazione usate nei valori di intestazione HTTP Authorization, ProxyAuthorization, WWW-Authenticate e Proxy-Authenticate HTTP.

La proprietà ProxyAuthenticate in HttpResponseHeaderCollection restituisce un oggetto HttpChallengeHeaderValueCollection. La proprietà WwwAuthenticate in HttpResponseHeaderCollection restituisce anche un oggetto HttpChallengeHeaderValueCollection.

Elenchi di membri della raccolta

Per JavaScript, HttpChallengeHeaderValueCollection include i membri visualizzati negli elenchi di membri. HttpChallengeHeaderValueCollection supporta inoltre i membri di Array.prototype e l'uso di un indice per accedere agli elementi.

Enumerazione della raccolta in C# o Microsoft Visual Basic

È possibile scorrere un oggetto HttpChallengeHeaderValueCollection in C# o Microsoft Visual Basic. In molti casi, ad esempio usando la sintassi foreach , il compilatore esegue questo cast per l'utente e non è necessario eseguire il cast in IEnumerable<HttpChallengeHeaderValue> modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast dell'oggetto raccolta in IEnumerable<T> con un vincolo HttpChallengeHeaderValue .

Proprietà

Size	Ottiene il numero di oggetti HttpChallengeHeaderValue nell'insieme.

Metodi

Append(HttpChallengeHeaderValue)	Aggiunge un nuovo elemento HttpChallengeHeaderValue alla fine della raccolta.
Clear()	Rimuove tutti gli oggetti HttpChallengeHeaderValue dall'insieme.
First()	Recupera un iteratore al primo elemento HttpChallengeHeaderValue nella raccolta.
GetAt(UInt32)	Restituisce l'oggetto HttpChallengeHeaderValue in corrispondenza dell'indice specificato nell'insieme.
GetMany(UInt32, HttpChallengeHeaderValue[])	Recupera gli elementi HttpChallengeHeaderValue che iniziano dall'indice specificato nella raccolta.
GetView()	Restituisce una visualizzazione non modificabile di HttpChallengeHeaderValueCollection.
IndexOf(HttpChallengeHeaderValue, UInt32)	Recupera l'indice di un oggetto HttpChallengeHeaderValue nell'insieme.
InsertAt(UInt32, HttpChallengeHeaderValue)	Inserisce un valore HttpChallengeHeaderValue nell'insieme in corrispondenza dell'indice specificato.
ParseAdd(String)	Analizza e aggiunge una voce a HttpChallengeHeaderValueCollection.
RemoveAt(UInt32)	Rimuove la voce in corrispondenza dell'indice specificato da HttpChallengeHeaderValueCollection.
RemoveAtEnd()	Rimuove l'ultimo elemento HttpChallengeHeaderValue dall'insieme.
ReplaceAll(HttpChallengeHeaderValue[])	Sostituisce tutti gli elementi HttpChallengeHeaderValue nella raccolta con gli elementi HttpChallengeHeaderValue specificati.
SetAt(UInt32, HttpChallengeHeaderValue)	Imposta HttpChallengeHeaderValue in corrispondenza dell'indice specificato nell'insieme.
ToString()	Restituisce una stringa che rappresenta l'oggetto HttpChallengeHeaderValueCollection corrente.
TryParseAdd(String)	Tenta di analizzare e aggiungere l'elemento specificato a HttpChallengeHeaderValueCollection.

Vedi anche

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