Partilhar via


HttpLanguageRangeWithQualityHeaderValue Classe

Definição

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.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
Herança
Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue
Atributos
Implementações

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.

Aplica-se a

Confira também