HttpChallengeHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

Stellt den Wert des HTTP-Headers Proxy-Authenticate oder WWW-Authenticate für eine HTTP-Antwort dar.

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

Vererbung

Object Platform::Object IInspectable HttpChallengeHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der folgende Beispielcode zeigt eine Methode zum Abrufen und Festlegen des Proxy-Authenticate-HTTP-Headers für ein HttpResponseMessage-Objekt mithilfe der Eigenschaften und Methoden der Klassen HttpChallengeHeaderValueCollection und 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());
        }

Hinweise

Die HttpChallengeHeaderValueCollection stellt den Wert des HTTP-Headers Proxy-Authenticate oder WWW-Authenticate für eine HTTP-Antwort dar.

HttpChallengeHeaderValueCollection stellt einen Sammlungscontainer für Instanzen der HttpChallengeHeaderValue-Klasse bereit, die für Authentifizierungsinformationen verwendet wird, die in den HTTP-Headerwerten Authorization, ProxyAuthorization, WWW-Authenticate und Proxy-Authenticate verwendet werden.

Die ProxyAuthenticate-Eigenschaft für HttpResponseHeaderCollection gibt ein HttpChallengeHeaderValueCollection-Objekt zurück. Die WwwAuthenticate-Eigenschaft für HttpResponseHeaderCollection gibt auch ein HttpChallengeHeaderValueCollection-Objekt zurück.

Auflistungselementlisten

Für JavaScript verfügt HttpChallengeHeaderValueCollection über die in den Memberlisten angezeigten Member. Darüber hinaus unterstützt HttpChallengeHeaderValueCollection Member von Array.prototype und verwendet einen Index für den Zugriff auf Elemente.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Sie können ein HttpChallengeHeaderValueCollection-Objekt in C# oder Microsoft Visual Basic durchlaufen. In vielen Fällen, z. B. mit foreach-Syntax , führt der Compiler diese Umwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<HttpChallengeHeaderValue> umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie das Auflistungsobjekt mit einer HttpChallengeHeaderValue-Einschränkung in IEnumerable<T> um.

Eigenschaften

Size	Ruft die Anzahl der HttpChallengeHeaderValue-Objekte in der Auflistung ab.

Methoden

Append(HttpChallengeHeaderValue)	Fügt am Ende der Auflistung ein neues HttpChallengeHeaderValue-Element hinzu.
Clear()	Entfernt alle HttpChallengeHeaderValue-Objekte aus der Auflistung.
First()	Ruft einen Iterator zum ersten HttpChallengeHeaderValue-Element in der Auflistung ab.
GetAt(UInt32)	Gibt httpChallengeHeaderValue am angegebenen Index in der Auflistung zurück.
GetMany(UInt32, HttpChallengeHeaderValue[])	Ruft die HttpChallengeHeaderValue-Elemente ab, die am angegebenen Index in der Auflistung beginnen.
GetView()	Gibt eine unveränderliche Ansicht der HttpChallengeHeaderValueCollection zurück.
IndexOf(HttpChallengeHeaderValue, UInt32)	Ruft den Index eines HttpChallengeHeaderValue in der Auflistung ab.
InsertAt(UInt32, HttpChallengeHeaderValue)	Fügt ein HttpChallengeHeaderValue am angegebenen Index in die Auflistung ein.
ParseAdd(String)	Analysiert und fügt der HttpChallengeHeaderValueCollection einen Eintrag hinzu.
RemoveAt(UInt32)	Entfernt den Eintrag am angegebenen Index aus der HttpChallengeHeaderValueCollection.
RemoveAtEnd()	Entfernt das letzte HttpChallengeHeaderValue-Element aus der Auflistung.
ReplaceAll(HttpChallengeHeaderValue[])	Ersetzt alle HttpChallengeHeaderValue-Elemente in der Auflistung durch die angegebenen HttpChallengeHeaderValue-Elemente .
SetAt(UInt32, HttpChallengeHeaderValue)	Legt den HttpChallengeHeaderValue auf den angegebenen Index in der Auflistung fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle HttpChallengeHeaderValueCollection-Objekt darstellt.
TryParseAdd(String)	Versucht, das angegebene Element zu analysieren und der HttpChallengeHeaderValueCollection hinzuzufügen.

Weitere Informationen

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