HttpLanguageRangeWithQualityHeaderValue Classe
Définition
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.
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
- 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. |