PermilleFormatter Klasse

Definition

Namespace:

Windows.Globalization.NumberFormatting

ProMillage werden Formate und Analysevorgänge analysiert.

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

Vererbung

Object Platform::Object IInspectable PermilleFormatter

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

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

Eigenschaften

FractionDigits	Ruft die Mindestanzahl von Ziffern ab, die für den Bruchteil der Promille angezeigt werden sollen, oder legt diese fest.
GeographicRegion	Ruft die Region ab, die beim Formatieren und Analysieren von Promillewerten verwendet wird.
IntegerDigits	Ruft die Mindestanzahl von Ziffern ab, die für den ganzzahligen Teil der Promille angezeigt werden sollen, oder legt diese fest.
IsDecimalPointAlwaysDisplayed	Ruft ab oder legt fest, ob der Dezimalpunkt der Promille immer angezeigt werden soll.
IsGrouped	Ruft ab oder legt fest, ob der ganzzahlige Teil der Promille gruppiert werden soll.
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 Promillewerten verwendet werden.
NumberRounder	Ruft die aktuelle Rundungsstrategie ab, die beim Formatieren proMille verwendet werden soll, oder legt diese fest.
NumeralSystem	Ruft das Nummerierungssystem ab, das zum Formatieren und Analysieren von Promillewerten verwendet wird, oder legt es fest.
ResolvedGeographicRegion	Ruft die geografische Region ab, die zuletzt zum Formatieren oder Analysieren von Promillewerten verwendet wurde.
ResolvedLanguage	Ruft die Sprache ab, die zuletzt zum Formatieren oder Analysieren von Promillewerten verwendet wurde.
SignificantDigits	Ruft die aktuelle Auffüllung auf signifikante Ziffern ab, wenn eine Promille formatiert ist, oder legt sie fest.

Methoden

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

Weitere Informationen

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