HttpMediaTypeWithQualityHeaderValueCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

Représente la valeur de l’en-tête Accepter HTTP sur une requête HTTP.

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

Héritage

Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<HttpMediaTypeWithQualityHeaderValue> IEnumerable<HttpMediaTypeWithQualityHeaderValue> IVector<HttpMediaTypeWithQualityHeaderValue> IList<HttpMediaTypeWithQualityHeaderValue> IStringable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de code suivant montre une méthode permettant d’obtenir et de définir l’en-tête HTTP Accept sur un objet HttpRequestMessage à l’aide des propriétés et des méthodes des classes HttpMediaTypeWithQualityHeaderValueCollection et 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());
        }

Remarques

HttpMediaTypeWithQualityHeaderValueCollection représente la valeur de l’en-tête HTTP Accepter sur une requête HTTP.

HttpMediaTypeWithQualityHeaderValueCollection est une collection d’objets HttpMediaTypeWithQualityHeaderValue utilisés pour les informations d’acceptation dans l’en-tête HTTP Accept .

La propriété Accept sur httpRequestHeaderCollection renvoie un objet HttpMediaTypeWithQualityHeaderValueCollection.

Propriétés

Size	Obtient le nombre d’objets HttpMediaTypeWithQualityHeaderValue dans la collection.

Méthodes

Append(HttpMediaTypeWithQualityHeaderValue)	Ajoute un nouvel élément HttpMediaTypeWithQualityHeaderValue à la fin de la collection.
Clear()	Supprime tous les objets de la collection.
First()	Récupère un itérateur vers le premier élément HttpMediaTypeWithQualityHeaderValue de la collection.
GetAt(UInt32)	Renvoie la valeur HttpMediaTypeWithQualityHeaderValue à l’index spécifié dans la collection.
GetMany(UInt32, HttpMediaTypeWithQualityHeaderValue[])	Récupère les éléments HttpMediaTypeWithQualityHeaderValue qui commencent à l’index spécifié dans la collection.
GetView()	Renvoie une vue immuable de HttpMediaTypeWithQualityHeaderValueCollection.
IndexOf(HttpMediaTypeWithQualityHeaderValue, UInt32)	Récupère l’index d’un HttpMediaTypeWithQualityHeaderValue dans la collection.
InsertAt(UInt32, HttpMediaTypeWithQualityHeaderValue)	Insère une valeur HttpMediaTypeWithQualityHeaderValue dans la collection à l’index spécifié.
ParseAdd(String)	Analyse et ajoute une entrée à HttpMediaTypeWithQualityHeaderValueCollection.
RemoveAt(UInt32)	Supprime l’entrée à l’index spécifié de l’objet HttpMediaTypeWithQualityHeaderValueCollection.
RemoveAtEnd()	Supprime le dernier élément HttpMediaTypeWithQualityHeaderValue de la collection.
ReplaceAll(HttpMediaTypeWithQualityHeaderValue[])	Remplace tous les éléments HttpMediaTypeWithQualityHeaderValue de la collection par les éléments HttpMediaTypeWithQualityHeaderValue spécifiés.
SetAt(UInt32, HttpMediaTypeWithQualityHeaderValue)	Définit la valeur HttpMediaTypeWithQualityHeaderValue à l’index spécifié dans la collection.
ToString()	Renvoie une chaîne qui représente l’objet HttpMediaTypeWithQualityHeaderValueCollection actuel.
TryParseAdd(String)	Tente d’analyser et d’ajouter l’élément spécifié à HttpMediaTypeWithQualityHeaderValueCollection.

Voir aussi

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