Freigeben über


HttpCookiePairHeaderValueCollection Klasse

Definition

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpCookiePairHeaderValueCollection final : 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpCookiePairHeaderValueCollection : IEnumerable<HttpCookiePairHeaderValue>, IList<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
Implementiert

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.

Gilt für:

Weitere Informationen