HttpLanguageRangeWithQualityHeaderValue Classe

Définition

Représente les informations de langue d’acceptation utilisées dans l’en-tête HTTP Accept-Language sur une requête HTTP.

public ref class HttpLanguageRangeWithQualityHeaderValue sealed : IStringable
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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 HttpLanguageRangeWithQualityHeaderValue final : 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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpLanguageRangeWithQualityHeaderValue final : IStringable
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 HttpLanguageRangeWithQualityHeaderValue : 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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.Headers.IHttpLanguageRangeWithQualityHeaderValueFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpLanguageRangeWithQualityHeaderValue : IStringable
function HttpLanguageRangeWithQualityHeaderValue(languageRange, quality)
Public NotInheritable Class HttpLanguageRangeWithQualityHeaderValue
Implements IStringable
Héritage
Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue
Attributs
Implémente

Configuration requise pour Windows

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

Remarques

La classe HttpLanguageRangeWithQualityHeaderValue représente les informations de langue d’acceptation utilisées dans l’en-tête HTTP Accept-Language sur une requête HTTP.

L’en-tête Accept-Language peut être utilisé par les clients pour indiquer l’ensemble de langages naturels préférés dans la réponse. Une plage de langues est définie dans la RFC 4647 de l’IETF. Il s’agit d’une balise de langue, ou d’une balise de langue partielle, qui indique une langue ou une plage de langues. Par exemple , en-us serait l’anglais américain, et en-gb serait anglais britannique. Alors que en est une plage de langues, c’est-à-dire toute variante de l’anglais.

Chaque plage de langues peut recevoir une valeur de qualité associée représentant une estimation de la préférence de l’utilisateur pour les langues spécifiées par cette plage. La qualité doit être comprise entre 0,0 et 1,0.

Certains destinataires traitent l’ordre dans lequel les balises de langue sont répertoriées comme une indication de priorité décroissante, en particulier pour les balises auxquelles sont attribuées des valeurs de qualité égales (aucune valeur n’est identique à q=1). Toutefois, ce comportement ne peut pas être utilisé. Pour assurer la cohérence et optimiser l’interopérabilité, de nombreux agents utilisateur attribuent à chaque balise de langue une valeur de qualité unique tout en les répertoriant par ordre de diminution de la qualité.

La propriété AcceptLanguage sur httpRequestHeaderCollection renvoie un objet HttpLanguageRangeWithQualityHeaderValueCollection qui contient des objets HttpLanguageRangeWithQualityHeaderValue.

Constructeurs

HttpLanguageRangeWithQualityHeaderValue(String)

Initialise une nouvelle instance de la classe HttpLanguageRangeWithQualityHeaderValue avec des informations de plage de langage.

HttpLanguageRangeWithQualityHeaderValue(String, Double)

Initialise une nouvelle instance de la classe HttpLanguageRangeWithQualityHeaderValue avec des informations de plage de langue et de qualité.

Propriétés

LanguageRange

Obtient la valeur des informations de plage de langues de l’élément HttpLanguageRangeWithQualityHeaderValue utilisé dans l’en-tête HTTP Accept-Language .

Quality

Obtient la valeur du facteur qvalue ou de qualité de l’élément HttpLanguageRangeWithQualityHeaderValue utilisé dans l’en-tête HTTP Accept-Language .

Méthodes

Parse(String)

Convertit une chaîne en instance HttpLanguageRangeWithQualityHeaderValue.

ToString()

Renvoie une chaîne qui représente l’objet HttpLanguageRangeWithQualityHeaderValue actuel.

TryParse(String, HttpLanguageRangeWithQualityHeaderValue)

Détermine si une chaîne est des informations HttpLanguageRangeWithQualityHeaderValue valides.

S’applique à

Voir aussi