HttpLanguageRangeWithQualityHeaderValueCollection Classe

Définition

Espace de noms:

Windows.Web.Http.Headers

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

public ref class HttpLanguageRangeWithQualityHeaderValueCollection sealed : IIterable<HttpLanguageRangeWithQualityHeaderValue ^>, IVector<HttpLanguageRangeWithQualityHeaderValue ^>, IStringable

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

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

Public NotInheritable Class HttpLanguageRangeWithQualityHeaderValueCollection
Implements IEnumerable(Of HttpLanguageRangeWithQualityHeaderValue), IList(Of HttpLanguageRangeWithQualityHeaderValue), IStringable

Héritage

Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValueCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<HttpLanguageRangeWithQualityHeaderValue> IEnumerable<HttpLanguageRangeWithQualityHeaderValue> IVector<HttpLanguageRangeWithQualityHeaderValue> IList<HttpLanguageRangeWithQualityHeaderValue> 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-Language sur un objet HttpRequestMessage à l’aide des propriétés et méthodes des classes HttpLanguageRangeWithQualityHeaderValueCollection et HttpLanguageRangeWithQualityHeaderValue .

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

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

            // Set the header with a string.
            parsedOk = request.Headers.AcceptLanguage.TryParseAdd("da");
            parsedOk = request.Headers.AcceptLanguage.TryParseAdd("en-gb;q=0.8");

            // Set the header with a strong type.
            request.Headers.AcceptLanguage.Add(new HttpLanguageRangeWithQualityHeaderValue("en", .7));

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

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

Remarques

La classe HttpLanguageRangeWithQualityHeaderValueCollection représente la valeur de l’en-tête HTTP Accept-Language sur une requête HTTP.

HttpLanguageRangeWithQualityHeaderValueCollection fournit un conteneur de collection pour les instances de la classe HttpLanguageRangeWithQualityHeaderValue utilisée pour accepter les informations de langue dans l’en-tête HTTP Accept-Language .

La propriété AcceptLanguage sur httpRequestHeaderCollection renvoie un objet HttpLanguageRangeWithQualityHeaderValueCollection.

Propriétés

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

Méthodes

Append(HttpLanguageRangeWithQualityHeaderValue)	Ajoute un nouvel élément HttpLanguageRangeWithQualityHeaderValue à 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 HttpLanguageRangeWithQualityHeaderValue de la collection.
GetAt(UInt32)	Renvoie la valeur HttpLanguageRangeWithQualityHeaderValue à l’index spécifié dans la collection.
GetMany(UInt32, HttpLanguageRangeWithQualityHeaderValue[])	Récupère les éléments HttpLanguageRangeWithQualityHeaderValue qui commencent à l’index spécifié dans la collection.
GetView()	Renvoie une vue immuable de l’objet HttpLanguageRangeWithQualityHeaderValueCollection.
IndexOf(HttpLanguageRangeWithQualityHeaderValue, UInt32)	Récupère l’index d’un objet HttpLanguageRangeWithQualityHeaderValue dans la collection.
InsertAt(UInt32, HttpLanguageRangeWithQualityHeaderValue)	Insère une valeur HttpLanguageRangeWithQualityHeaderValue dans la collection à l’index spécifié.
ParseAdd(String)	Analyse et ajoute une entrée à l’objet HttpLanguageRangeWithQualityHeaderValueCollection.
RemoveAt(UInt32)	Supprime l’entrée à l’index spécifié de l’objet HttpLanguageRangeWithQualityHeaderValueCollection.
RemoveAtEnd()	Supprime le dernier élément HttpLanguageRangeWithQualityHeaderValue de la collection.
ReplaceAll(HttpLanguageRangeWithQualityHeaderValue[])	Remplace tous les éléments HttpLanguageRangeWithQualityHeaderValue de la collection par les éléments HttpLanguageRangeWithQualityHeaderValue spécifiés.
SetAt(UInt32, HttpLanguageRangeWithQualityHeaderValue)	Définit httpLanguageRangeWithQualityHeaderValue à l’index spécifié dans la collection.
ToString()	Renvoie une chaîne qui représente l’objet HttpLanguageRangeWithQualityHeaderValueCollection actuel.
TryParseAdd(String)	Tente d’analyser et d’ajouter l’élément spécifié à l’objet HttpLanguageRangeWithQualityHeaderValueCollection.

Voir aussi

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValue
• HttpRequestHeaderCollection
• IIterable<T>
• IStringable
• IVector<T>