HttpMediaTypeWithQualityHeaderValueCollection Classe

Référence

Définition

Espace de noms:: Windows.Web.Http.Headers

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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)]
/// [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

Héritage: Object Platform::Object IInspectable HttpMediaTypeWithQualityHeaderValueCollection

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

S’applique à

Partager via