HttpMediaTypeWithQualityHeaderValueCollection Klasse

Definition

Namespace:

Windows.Web.Http.Headers

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

public ref class HttpMediaTypeWithQualityHeaderValueCollection sealed : IIterable<HttpMediaTypeWithQualityHeaderValue ^>, IVector<HttpMediaTypeWithQualityHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpMediaTypeWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpMediaTypeWithQualityHeaderValue), IList(Of HttpMediaTypeWithQualityHeaderValue), IStringable

Vererbung

Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

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

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

            // Set the header with a string.
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.2");
            parsedOk = request.Headers.Accept.TryParseAdd ("audio/*; q=0.4; mysetting=myvalue");

            // Set the header with a strong type.
            request.Headers.Accept.Add(new HttpMediaTypeWithQualityHeaderValue("audio/*", .6));

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

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

Hinweise

HttpMediaTypeWithQualityHeaderValueCollection stellt den Wert des Accept HTTP-Headers für eine HTTP-Anforderung dar.

HttpMediaTypeWithQualityHeaderValueCollection ist eine Auflistung von HttpMediaTypeWithQualityHeaderValue-Objekten , die für die Annahme von Informationen im HTTP Accept-Header verwendet werden.

Die Accept-Eigenschaft für httpRequestHeaderCollection gibt ein HttpMediaTypeWithQualityHeaderValueCollection-Objekt zurück.

Eigenschaften

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

Methoden

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

Weitere Informationen

• Accept
• HttpMediaTypeWithQualityHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>