HttpLanguageRangeWithQualityHeaderValue Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Web.Http.Headers

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IStringable

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