共用方式為


HttpLanguageRangeWithQualityHeaderValue 類別

定義

表示在 HTTP 要求上 Accept-Language 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
繼承
Object Platform::Object IInspectable HttpLanguageRangeWithQualityHeaderValue
屬性
實作

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 資訊。

適用於

另請參閱