PermilleFormatter クラス

定義

名前空間:

Windows.Globalization.NumberFormatting

パーミラージュの書式設定と解析を行います。

public ref class PermilleFormatter sealed : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

/// [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.Globalization.NumberFormatting.IPermilleFormatterFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PermilleFormatter final : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

[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.Globalization.NumberFormatting.IPermilleFormatterFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PermilleFormatter : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

function PermilleFormatter(languages, geographicRegion)

Public NotInheritable Class PermilleFormatter
Implements INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

継承

Object Platform::Object IInspectable PermilleFormatter

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

// This scenario uses the Windows.Globalization.NumberFormatting.PercentFormatter and
// the Windows.Globalization.NumberFormatting.PermilleFormatter classes to format numbers
// as a percent or a permille.

//using System.Text;
//using Windows.Globalization.NumberFormatting;

StringBuilder sb = new StringBuilder();

// Create numbers to format.
double randomNumber = new Random().NextDouble();
ulong fixedNumber = 500;

// Create percent formatters.
PercentFormatter defaultPercentFormatter = new PercentFormatter();
PercentFormatter languagePercentFormatter = new PercentFormatter(new[] { "fr-FR" }, "ZZ");

// Create permille formatters.
PermilleFormatter defaultPermilleFormatter = new PermilleFormatter();
PermilleFormatter languagePermilleFormatter = new PermilleFormatter(new[] { "ar" }, "ZZ");

// Format random numbers as percent or permille.
sb.AppendLine("Random number: " + randomNumber);
sb.AppendLine("Percent formatted: " + defaultPercentFormatter.Format(randomNumber));
sb.AppendLine("Permille formatted: " + defaultPermilleFormatter.Format(randomNumber));
sb.AppendLine();
sb.AppendLine("Language-specific percent formatted: " + languagePercentFormatter.Format(randomNumber));
sb.AppendLine("Language-specific permille formatted: " + languagePermilleFormatter.Format(randomNumber));
sb.AppendLine();
sb.AppendLine("Fixed number: " + fixedNumber);

// Format fixed number with grouping.
defaultPercentFormatter.IsGrouped = true;
sb.AppendLine("Percent formatted (grouped): " + defaultPercentFormatter.Format(fixedNumber));

//Format with grouping using French language.
languagePercentFormatter.IsGrouped = true;
sb.AppendLine("Percent formatted (grouped as fr-FR): " + defaultPercentFormatter.Format(fixedNumber));

// Format with no fraction digits.
defaultPercentFormatter.FractionDigits = 0;
sb.AppendLine("Percent formatted (no fractional digits): " + defaultPercentFormatter.Format(fixedNumber));

// Format always with a decimal point.
defaultPercentFormatter.IsDecimalPointAlwaysDisplayed = true;
sb.AppendLine("Percent formatted (always with a decimal point): " + defaultPercentFormatter.Format(fixedNumber));

注釈

注意

アプリがこのクラスで使用されている言語タグを 各国語サポート 関数に渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

コンストラクター

PermilleFormatter()	PermilleFormatter オブジェクトを作成し、既定値に初期化します。
PermilleFormatter(IIterable<String>, String)	言語リストと地理的リージョンによって初期化された PermilleFormatter オブジェクトを作成します。

プロパティ

FractionDigits	パーミラージュの分数部分に表示する最小桁数を取得または設定します。
GeographicRegion	permille 値の書式設定と解析時に使用される領域を取得します。
IntegerDigits	permillage の整数部分に表示する最小桁数を取得または設定します。
IsDecimalPointAlwaysDisplayed	permillage の小数点を常に表示するかどうかを取得または設定します。
IsGrouped	permillage の整数部分をグループ化するかどうかを取得または設定します。
IsZeroSigned	-0 を "-0" または "0" として書式設定するかどうかを取得または設定します。
Languages	permille 値の書式設定と解析に使用される言語識別子の優先順位リストを取得します。
NumberRounder	パーミルの書式設定時に使用する現在の丸め方法を取得または設定します。
NumeralSystem	permille 値の書式設定と解析に使用される番号付けシステムを取得または設定します。
ResolvedGeographicRegion	最後にパーミル値の書式設定または解析に使用された地理的リージョンを取得します。
ResolvedLanguage	最後に permille 値の書式設定または解析に使用された言語を取得します。
SignificantDigits	permille が書式設定されている場合に、現在の埋め込みを有効桁数に設定します。

メソッド

Format(Double)	Double permillage の文字列表現を返します。
Format(Int64)	Int64 permillage の文字列表現を返します。
Format(UInt64)	UInt64 パーミラージュの文字列表現を返します。
FormatDouble(Double)	Double permillage の文字列表現を返します。
FormatInt(Int64)	Int64 permillage の文字列表現を返します。
FormatUInt(UInt64)	UInt64 パーミラージュの文字列表現を返します。
ParseDouble(String)	Double permillage の文字列表現の解析を試みます。
ParseInt(String)	整数パーミラージュの文字列表現の解析を試みます。
ParseUInt(String)	符号なし整数 permillage の文字列表現の解析を試みます。

こちらもご覧ください

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• 数字の書式設定と解析サンプルに関するページ
• 数値の書式設定と解析のサンプル (Windows 10)