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 オブジェクトを含む HttpLanguageRangeWithQualityHeaderValueCollection を返します。

コンストラクター

HttpLanguageRangeWithQualityHeaderValue(String)	言語範囲情報を使用して 、HttpLanguageRangeWithQualityHeaderValue クラスの新しいインスタンスを初期化します。
HttpLanguageRangeWithQualityHeaderValue(String, Double)	言語範囲と品質情報を使用して 、HttpLanguageRangeWithQualityHeaderValue クラスの新しいインスタンスを初期化します。

プロパティ

LanguageRange	Accept-Language HTTP ヘッダーで使用される HttpLanguageRangeWithQualityHeaderValue から言語範囲情報の値を取得します。
Quality	Accept-Language HTTP ヘッダーで使用される HttpLanguageRangeWithQualityHeaderValue から qvalue または quality factor の値を取得します。

メソッド

Parse(String)	文字列を HttpLanguageRangeWithQualityHeaderValue インスタンスに変換します。
ToString()	現在の HttpLanguageRangeWithQualityHeaderValue オブジェクトを表す文字列を返します。
TryParse(String, HttpLanguageRangeWithQualityHeaderValue)	文字列が有効な HttpLanguageRangeWithQualityHeaderValue 情報であるかどうかを判断します。

こちらもご覧ください

• AcceptLanguage
• HttpLanguageRangeWithQualityHeaderValueCollection
• HttpRequestHeaderCollection
• IStringable