PercentFormatter Klasse

Definition

Namespace:

Windows.Globalization.NumberFormatting

Formate und Analysiert Prozentwerte.

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

Vererbung

Object Platform::Object IInspectable PercentFormatter

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

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

Hinweise

Hinweis

Wenn Ihre App in dieser Klasse verwendete Sprachtags an alle Funktionen der National Language Support übergeben, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Konstruktoren

PercentFormatter()	Erstellt ein PercentFormatter-Objekt und initialisiert es mit Standardwerten.
PercentFormatter(IIterable<String>, String)	Erstellt ein PercentFormatter-Objekt , das von einer Sprachliste und einer geografischen Region initialisiert wird.

Eigenschaften

FractionDigits	Ruft die Mindestanzahl von Ziffern ab, die für den Bruchteil des Prozentsatzes angezeigt werden sollen, oder legt diese fest.
GeographicRegion	Ruft die Region ab, die beim Formatieren und Analysieren von Prozentsätzen verwendet wird.
IntegerDigits	Ruft die Mindestanzahl von Ziffern ab, die für den ganzzahligen Teil des Prozentsatzes angezeigt werden sollen, oder legt diese fest.
IsDecimalPointAlwaysDisplayed	Ruft ab oder legt fest, ob der Dezimalpunkt des Prozentsatzes immer angezeigt werden soll.
IsGrouped	Ruft ab, ob der ganzzahlige Teil des Prozentsatzes gruppiert werden soll, oder legt diese fest.
IsZeroSigned	Ruft ab oder legt fest, ob -0 als "-0" oder "0" formatiert ist.
Languages	Ruft die Prioritätsliste der Sprachbezeichner ab, die beim Formatieren und Analysieren von Prozentsätzen verwendet werden.
NumberRounder	Ruft die aktuelle Rundungsstrategie ab, die beim Formatieren von Prozenten verwendet werden soll, oder legt diese fest.
NumeralSystem	Ruft das Nummerierungssystem ab, das zum Formatieren und Analysieren von Prozentsätzen verwendet wird, oder legt es fest.
ResolvedGeographicRegion	Ruft die geografische Region ab, die zuletzt zum Formatieren oder Analysieren von Prozentwerten verwendet wurde.
ResolvedLanguage	Ruft die Sprache ab, die zuletzt zum Formatieren oder Analysieren von Prozentwerten verwendet wurde.
SignificantDigits	Ruft die aktuelle Auffüllung ab, oder legt sie auf signifikante Ziffern fest, wenn ein Prozent formatiert ist.

Methoden

Format(Double)	Gibt eine Zeichenfolgendarstellung eines Double-Prozentsatzes zurück.
Format(Int64)	Gibt eine Zeichenfolgendarstellung eines Int64-Prozentsatzes zurück.
Format(UInt64)	Gibt eine Zeichenfolgendarstellung eines UInt64-Prozentsatzes zurück.
FormatDouble(Double)	Gibt eine Zeichenfolgendarstellung eines Double-Prozentsatzes zurück.
FormatInt(Int64)	Gibt eine Zeichenfolgendarstellung eines Int64-Prozentsatzes zurück.
FormatUInt(UInt64)	Gibt eine Zeichenfolgendarstellung eines UInt64-Prozentsatzes zurück.
ParseDouble(String)	Versucht, eine Zeichenfolgendarstellung eines Double-Prozentsatzes zu analysieren.
ParseInt(String)	Versucht, eine Zeichenfolgendarstellung eines ganzzahligen Prozentsatzes zu analysieren.
ParseUInt(String)	Versucht, eine Zeichenfolgendarstellung eines ganzzahligen Prozentsatzes ohne Vorzeichen zu analysieren.

Weitere Informationen

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Beispiel für Zahlenformatierung und Analyse
• Zahlenformatierungs- und Analysebeispiel (Windows 10)