PercentFormatter Класс

Определение

Пространство имен:

Windows.Globalization.NumberFormatting

Форматирует и анализирует процентные значения.

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

function PercentFormatter(languages, geographicRegion)

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

Наследование

Object Platform::Object IInspectable PercentFormatter

Атрибуты

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.

Конструкторы

PercentFormatter()	Создает объект PercentFormatter и инициализирует его значениями по умолчанию.
PercentFormatter(IIterable<String>, String)	Создает объект PercentFormatter , инициализированный списком языков и географическим регионом.

Свойства

FractionDigits	Возвращает или задает минимальное число цифр, отображаемых для части доли процента.
GeographicRegion	Возвращает регион, используемый при форматировании и анализе в процентах.
IntegerDigits	Возвращает или задает минимальное число цифр, отображаемых для целочисленной части процента.
IsDecimalPointAlwaysDisplayed	Возвращает или задает значение, указывающее, должна ли всегда отображаться десятичная запятая процента.
IsGrouped	Возвращает или задает значение, указывающее, следует ли группировать целочисленную часть процента.
IsZeroSigned	Возвращает или задает значение , указывающее, имеет ли значение -0 или "0".
Languages	Возвращает список приоритетов идентификаторов языков, используемых при форматировании и анализе процентных значений.
NumberRounder	Возвращает или задает текущую стратегию округления, используемую при форматировании процентов.
NumeralSystem	Возвращает или задает систему нумерования, используемую для форматирования и анализа процентных значений.
ResolvedGeographicRegion	Возвращает географический регион, который последний раз использовался для форматирования или анализа процентных значений.
ResolvedLanguage	Возвращает язык, который последний раз использовался для форматирования или анализа процентных значений.
SignificantDigits	Возвращает или задает текущее заполнение значительными цифрами при форматировании процента.

Методы

Format(Double)	Возвращает строковое представление двойного процента.
Format(Int64)	Возвращает строковое представление процента Int64 .
Format(UInt64)	Возвращает строковое представление процента UInt64 .
FormatDouble(Double)	Возвращает строковое представление двойного процента.
FormatInt(Int64)	Возвращает строковое представление процента Int64 .
FormatUInt(UInt64)	Возвращает строковое представление процента UInt64 .
ParseDouble(String)	Пытается проанализировать строковое представление двойного процента.
ParseInt(String)	Пытается проанализировать строковое представление целочисленного процента.
ParseUInt(String)	Пытается проанализировать строковое представление процента целого числа без знака.

См. также раздел

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Пример форматирования и разбора чисел
• Пример форматирования и анализа чисел (Windows 10)