HttpLanguageRangeWithQualityHeaderValue Classe

Definição

Namespace:

Windows.Web.Http.Headers

Representa aceitar informações de idioma usadas no cabeçalho HTTP accept-language em uma solicitação HTTP.

public ref class HttpLanguageRangeWithQualityHeaderValue sealed : 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.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

Herança

Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe HttpLanguageRangeWithQualityHeaderValue representa aceitar informações de idioma usadas no cabeçalho HTTP Accept-Language em uma solicitação HTTP.

O cabeçalho Accept-Language pode ser usado por clientes para indicar o conjunto de idiomas naturais que são preferenciais na resposta. Um intervalo de idiomas é definido no IETF RFC 4647. É uma marca de idioma ou uma marca de idioma parcial, indicando um idioma ou um intervalo de idiomas. Por exemplo , en-us seria inglês americano, e en-gb seria inglês britânico. Embora en seja um intervalo de idiomas, o que significa qualquer variação do inglês.

Cada intervalo de idiomas pode receber um valor de qualidade associado que representa uma estimativa da preferência do usuário pelos idiomas especificados por esse intervalo. A qualidade deve estar no intervalo de 0,0 a 1,0.

Alguns destinatários tratam a ordem na qual as marcas de idioma são listadas como uma indicação de prioridade decrescente, especialmente para marcas que recebem valores de qualidade iguais (nenhum valor é igual a q=1). No entanto, esse comportamento não pode ser confiado. Para consistência e para maximizar a interoperabilidade, muitos agentes de usuário atribuem a cada marca de idioma um valor de qualidade exclusivo, além de listá-los em ordem de diminuição da qualidade.

A propriedade AcceptLanguage no HttpRequestHeaderCollection retorna um HttpLanguageRangeWithQualityHeaderValueCollection que contém objetos HttpLanguageRangeWithQualityHeaderValue.

Construtores

HttpLanguageRangeWithQualityHeaderValue(String)	Inicializa uma nova instância da classe HttpLanguageRangeWithQualityHeaderValue com informações de intervalo de idiomas.
HttpLanguageRangeWithQualityHeaderValue(String, Double)	Inicializa uma nova instância da classe HttpLanguageRangeWithQualityHeaderValue com informações de qualidade e intervalo de idiomas.

Propriedades

LanguageRange	Obtém o valor das informações do intervalo de idiomas do HttpLanguageRangeWithQualityHeaderValue usado no cabeçalho HTTP Accept-Language .
Quality	Obtém o valor do fator qvalue ou de qualidade do HttpLanguageRangeWithQualityHeaderValue usado no cabeçalho HTTP Accept-Language .

Métodos

Parse(String)	Converte uma cadeia de caracteres em uma instância HttpLanguageRangeWithQualityHeaderValue .
ToString()	Retorna uma cadeia de caracteres que representa o objeto HttpLanguageRangeWithQualityHeaderValue atual.
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	Determina se uma cadeia de caracteres é válida httpLanguageRangeWithQualityHeaderValue informações.

Confira também

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValueCollection
• HttpRequestHeaderCollection
• IStringable