Condividi tramite


HttpLanguageRangeWithQualityHeaderValue Classe

Definizione

Rappresenta le informazioni sulla lingua utilizzate nell'intestazione HTTP Accept-Language in una richiesta 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
Ereditarietà
Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La classe HttpLanguageRangeWithQualityHeaderValue rappresenta le informazioni sulla lingua utilizzate nell'intestazione HTTP Accept-Language in una richiesta HTTP.

L'intestazione Accept-Language può essere utilizzata dai client per indicare il set di linguaggi naturali preferiti nella risposta. Un intervallo di linguaggio è definito in IETF RFC 4647. Si tratta di un tag di lingua o di un tag di lingua parziale, che indica una lingua o un intervallo di lingue. Ad esempio en-us sarebbe inglese americano e en-gb sarebbe inglese britannico. Mentre en è un intervallo linguistico, ovvero qualsiasi variante dell'inglese.

A ogni intervallo di lingue può essere assegnato un valore di qualità associato che rappresenta una stima della preferenza dell'utente per le lingue specificate da tale intervallo. La qualità deve essere compreso nell'intervallo compreso tra 0,0 e 1,0.

Alcuni destinatari considerano l'ordine in cui i tag di lingua sono elencati come un'indicazione della priorità decrescente, in particolare per i tag assegnati a valori di qualità uguali (nessun valore è uguale a q=1). Tuttavia, questo comportamento non può essere considerato attendibile. Per coerenza e per ottimizzare l'interoperabilità, molti agenti utente assegnano a ogni tag di lingua un valore di qualità univoco, elencandoli anche in ordine di qualità decrescente.

La proprietà AcceptLanguage in HttpRequestHeaderCollection restituisce un oggetto HttpLanguageRangeWithQualityHeaderValueCollection che contiene oggetti HttpLanguageRangeWithQualityHeaderValue.

Costruttori

HttpLanguageRangeWithQualityHeaderValue(String)

Inizializza una nuova istanza della classe HttpLanguageRangeWithQualityHeaderValue con informazioni sull'intervallo di linguaggio.

HttpLanguageRangeWithQualityHeaderValue(String, Double)

Inizializza una nuova istanza della classe HttpLanguageRangeWithQualityHeaderValue con informazioni sull'intervallo di linguaggio e sulla qualità.

Proprietà

LanguageRange

Ottiene il valore delle informazioni relative all'intervallo di lingue da HttpLanguageRangeWithQualityHeaderValue utilizzato nell'intestazione HTTP Accept-Language .

Quality

Ottiene il valore del fattore di qualità o qvalue da HttpLanguageRangeWithQualityHeaderValue utilizzato nell'intestazione HTTP Accept-Language .

Metodi

Parse(String)

Converte una stringa in un'istanza HttpLanguageRangeWithQualityHeaderValue .

ToString()

Restituisce una stringa che rappresenta l'oggetto HttpLanguageRangeWithQualityHeaderValue corrente.

TryParse(String, HttpLanguageRangeWithQualityHeaderValue)

Determina se una stringa è valida per le informazioni HttpLanguageRangeWithQualityHeaderValue .

Si applica a

Vedi anche