HttpCookiePairHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

Stellt den Wert des Cookie-HTTP-Headers für eine HTTP-Anforderung dar.

public ref class HttpCookiePairHeaderValueCollection sealed : IIterable<HttpCookiePairHeaderValue ^>, IVector<HttpCookiePairHeaderValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HttpCookiePairHeaderValueCollection final : IIterable<HttpCookiePairHeaderValue>, IVector<HttpCookiePairHeaderValue>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HttpCookiePairHeaderValueCollection : IEnumerable<HttpCookiePairHeaderValue>, IList<HttpCookiePairHeaderValue>, IStringable

Public NotInheritable Class HttpCookiePairHeaderValueCollection
Implements IEnumerable(Of HttpCookiePairHeaderValue), IList(Of HttpCookiePairHeaderValue), IStringable

Vererbung

Object Platform::Object IInspectable HttpCookiePairHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IIterable<T> IEnumerable<T> IIterable<HttpCookiePairHeaderValue> IEnumerable<HttpCookiePairHeaderValue> IVector<HttpCookiePairHeaderValue> IList<HttpCookiePairHeaderValue> 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 Cookie-HTTP-Headers für ein HttpRequestMessage-Objekt mithilfe der Eigenschaften und Methoden der Klassen HttpCookiePairHeaderValueCollection und HttpCookiePairHeaderValue.

using System;
using Windows.Web.Http;
using Windows.Web.Http.Headers;

        public void DemonstrateHeaderRequestCookie() {
            var request = new HttpRequestMessage();
            bool parsedOk = false;

            // Set the header with a string.
            parsedOk = request.Headers.Cookie.TryParseAdd("cookieName=cookieValue");

            // Set the header with a strong type.
            request.Headers.Cookie.Add(new HttpCookiePairHeaderValue("cookie2", "value2"));

            // Get the strong type out
            foreach (var value in request.Headers.Cookie) {
                System.Diagnostics.Debug.WriteLine("One of the Cookie values: {0}={1}", value.Name, value.Value);
            }

Hinweise

Die HttpCookiePairHeaderValueCollection-Klasse stellt den Wert des COOKIE-HTTP-Headers für eine HTTP-Anforderung dar.

HttpCookiePairHeaderValueCollection stellt einen Sammlungscontainer für Instanzen der HttpCookiePairHeaderValue-Klasse bereit, die für Cookieinformationen im HTTP-Header cookie verwendet wird.

Die Cookie-Eigenschaft für die HttpRequestHeaderCollection gibt ein HttpCookiePairHeaderValueCollection-Objekt zurück.

Eigenschaften

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

Methoden

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

Weitere Informationen

• IVector<T>
• IIterable<T>
• IStringable