HttpLanguageRangeWithQualityHeaderValue 類別

定義

命名空間:

Windows.Web.Http.Headers

表示在 HTTP 要求上 Accept-Language 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

繼承

Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IStringable

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

HttpLanguageRangeWithQualityHeaderValue 類別代表在 HTTP 要求上 Accept-Language HTTP 標頭中使用的接受語言資訊。

用戶端可以使用 Accept-Language標頭來指出回應中慣用的自然語言集。 語言範圍定義于 IETF RFC 4647中。 它是語言標記或部分語言標籤，指出語言或語言範圍。 例如 ，en-us 會是美式英文， 而 en-gb 會是英式英文。 雖然 en 是語言範圍，表示任何英文變化。

每個語言範圍都可以提供相關聯的品質值，代表該範圍所指定語言的使用者喜好設定估計值。 品質必須介於 0.0 到 1.0 的範圍內。

某些收件者會將語言標記列為遞減優先順序的順序，特別是針對指派相同品質值的標籤， (沒有值與 q=1 相同) 。 不過，無法依賴此行為。 為了一致性和最大化互通性，許多使用者代理程式都會指派每個語言標記唯一的品質值，同時列出它們以降低品質的順序。

HttpRequestHeaderCollection上的AcceptLanguage屬性會傳回HttpLanguageRangeWithQualityHeaderValueCollection，其中包含 HttpLanguageRangeWithQualityHeaderValue 物件。

建構函式

HttpLanguageRangeWithQualityHeaderValue(String)	使用語言範圍資訊，初始化 HttpLanguageRangeWithQualityHeaderValue 類別的新實例。
HttpLanguageRangeWithQualityHeaderValue(String, Double)	使用語言範圍和品質資訊，初始化 HttpLanguageRangeWithQualityHeaderValue 類別的新實例。

屬性

LanguageRange	從Accept-Language HTTP 標頭中使用的HttpLanguageRangeWithQualityHeaderValue取得語言範圍資訊的值。
Quality	從Accept-Language HTTP 標頭中使用的HttpLanguageRangeWithQualityHeaderValue取得qvalue或品質因素的值。

方法

Parse(String)	將字串轉換成 HttpLanguageRangeWithQualityHeaderValue 實例。
ToString()	會傳回代表目前 HttpLanguageRangeWithQualityHeaderValue 物件的字串。
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	判斷字串是否為有效的 HttpLanguageRangeWithQualityHeaderValue 資訊。

另請參閱

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValueCollection
• HttpRequestHeaderCollection
• IStringable