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));

備註

注意

如果您的 app 會將此類別中使用的語言標籤傳遞給任何 國家語言支援 函式，則必須先呼叫 ResolveLocaleName來轉換標籤。

建構函式

PermilleFormatter()	建立 PermilleFormatter 物件，並將其初始化為預設值。
PermilleFormatter(IIterable<String>, String)	建立由語言清單和地理區域初始化的 PermilleFormatter 物件。

屬性

FractionDigits	取得或設定要針對每車部分的分數部分顯示的最小位數。
GeographicRegion	取得格式化和剖析每千分之一值時所使用的區域。
IntegerDigits	取得或設定要針對每車整數部分顯示的最小位數。
IsDecimalPointAlwaysDisplayed	取得或設定是否應該一律顯示每車的小數點。
IsGrouped	取得或設定是否應該將每車的整數部分分組。
IsZeroSigned	取得或設定 -0 是否格式化為 「-0」 或 「0」。
Languages	取得格式化和剖析每千分之一值時所使用的語言識別項優先順序清單。
NumberRounder	取得或設定目前四捨五入策略，以在格式化每車時使用。
NumeralSystem	取得或設定用來格式化和剖析每千分之一值的編號系統。
ResolvedGeographicRegion	取得最近用來格式化或剖析每千分之一值的地理區域。
ResolvedLanguage	取得最近用來格式化或剖析每千分之一值的語言。
SignificantDigits	取得或設定格式化 permille 時，目前填補為有效位數。

方法

Format(Double)	傳回 Double permillage 的字串表示。
Format(Int64)	傳回 Int64 permillage 的字串表示。
Format(UInt64)	傳回 UInt64 permillage 的字串表示。
FormatDouble(Double)	傳回 Double permillage 的字串表示。
FormatInt(Int64)	傳回 Int64 permillage 的字串表示。
FormatUInt(UInt64)	傳回 UInt64 permillage 的字串表示。
ParseDouble(String)	嘗試剖析 雙 車數的字串表示。
ParseInt(String)	嘗試剖析整數的字串標記法。
ParseUInt(String)	嘗試剖析不帶正負號整數的字串標記法。

另請參閱

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• 數字格式化及剖析範例
• 數位格式設定和剖析範例 (Windows 10)