HttpConnectionOptionHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

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

public ref class HttpConnectionOptionHeaderValueCollection sealed : IIterable<HttpConnectionOptionHeaderValue ^>, IVector<HttpConnectionOptionHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpConnectionOptionHeaderValueCollection
Implements IEnumerable(Of HttpConnectionOptionHeaderValue), IList(Of HttpConnectionOptionHeaderValue), IStringable

Vererbung

Object Platform::Object IInspectable HttpConnectionOptionHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Connection.TryParseAdd("close");

            // Set the header with a strong type.
            request.Headers.Connection.Add(new HttpConnectionOptionHeaderValue("cache-control"));

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

            // The ToString() is useful for diagnostics, too.
            System.Diagnostics.Debug.WriteLine("The Connection ToString() results: {0}", request.Headers.Connection.ToString());
        }

Hinweise

Die HttpConnectionOptionHeaderValueCollection stellt den Wert des HTTP-Headers "Connection " für eine HTTP-Anforderung dar.

HttpConnectionOptionHeaderValueCollection ist eine Auflistung von HttpConnectionOptionHeaderValue-Objekten , die für Verbindungsinformationen im HTTP-Verbindungsheader verwendet werden.

Die Connection-Eigenschaft für die HttpRequestHeaderCollection gibt ein HttpConnectionOptionHeaderValueCollection-Objekt zurück.

Auflistungsmemberlisten

Für JavaScript enthält HttpConnectionOptionHeaderValueCollection die Member, die in den Memberlisten angezeigt werden. Darüber hinaus unterstützt HttpConnectionOptionHeaderValueCollection Member von Array.prototype und die Verwendung eines Indexes für den Zugriff auf Elemente.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

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

Eigenschaften

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

Methoden

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

Weitere Informationen

• Connection
• HttpConnectionOptionHeaderValue
• HttpRequestHeaderCollection
• HttpRequestMessage
• IIterable<T>
• IStringable
• IVector<T>