Freigeben über


HttpMediaTypeWithQualityHeaderValueCollection Klasse

Definition

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

Gilt für:

Weitere Informationen