HttpProductInfoHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

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

public ref class HttpProductInfoHeaderValueCollection sealed : IIterable<HttpProductInfoHeaderValue ^>, IVector<HttpProductInfoHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpProductInfoHeaderValueCollection
Implements IEnumerable(Of HttpProductInfoHeaderValue), IList(Of HttpProductInfoHeaderValue), IStringable

Vererbung

Object Platform::Object IInspectable HttpProductInfoHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

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

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

            // Set the header with a string.
            parsedOk = request.Headers.UserAgent.TryParseAdd("testprogram/1.0");

            // Set the header with a strong type.
            request.Headers.UserAgent.Add(new HttpProductInfoHeaderValue("myprogram", "2.2"));

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

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

Hinweise

Die HttpProductInfoHeaderValueCollection stellt den Wert des User-Agent-HTTP-Headers für eine HTTP-Anforderung dar.

Die HttpProductInfoHeaderValueCollection ist eine Sammlung von HttpProductInfoHeaderValue-Objekten, die für Produktinformationen im HTTP User-Agent-Header verwendet werden.

Der User-Agent-Header enthält Informationen zum Benutzer-Agent, der die Anforderung stammt. Der User-Agent-Header kann mehrere Produkttoken und Kommentare enthalten, die den Benutzer-Agent und alle Unterprodukte identifizieren.

Die UserAgent-Eigenschaft für httpRequestHeaderCollection gibt ein HttpProductInfoHeaderValueCollection-Objekt zurück.

Eigenschaften

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

Methoden

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

Weitere Informationen

• HttpProductInfoHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>
• UserAgent