PercentFormatter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Форматирует и анализирует процентные значения.
public ref class PercentFormatter sealed : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.NumberFormatting.IPercentFormatterFactory, 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 PercentFormatter final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.NumberFormatting.IPercentFormatterFactory), 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 PercentFormatter : 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, ISignificantDigitsOptionfunction PercentFormatter(languages, geographicRegion)Public NotInheritable Class PercentFormatter
Implements 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) |
Пытается проанализировать строковое представление процента целого числа без знака. |