PermilleFormatter Classe

Définition

Espace de noms:

Windows.Globalization.NumberFormatting

Met en forme et analyse les permillages.

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

Héritage

Object Platform::Object IInspectable PermilleFormatter

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

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

Remarques

Notes

Si votre application transmet les balises de langue utilisées dans cette classe à des fonctions de support linguistique national , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Constructeurs

PermilleFormatter()	Crée un objet PermilleFormatter et l’initialise avec les valeurs par défaut.
PermilleFormatter(IIterable<String>, String)	Crée un objet PermilleFormatter initialisé par une liste de langues et une région géographique.

Propriétés

FractionDigits	Obtient ou définit le nombre minimal de chiffres à afficher pour la partie fractionnaire du permillage.
GeographicRegion	Obtient la région utilisée lors de la mise en forme et de l’analyse des valeurs permille.
IntegerDigits	Obtient ou définit le nombre minimal de chiffres à afficher pour la partie entière du permillage.
IsDecimalPointAlwaysDisplayed	Obtient ou définit si la virgule décimale du permillage doit toujours être affichée.
IsGrouped	Obtient ou définit si la partie entière du permillage doit être groupée.
IsZeroSigned	Obtient ou définit si -0 est au format « -0 » ou « 0 ».
Languages	Obtient la liste de priorité des identificateurs de langue qui est utilisée lors de la mise en forme et de l’analyse des valeurs permille.
NumberRounder	Obtient ou définit la stratégie d’arrondi actuelle à utiliser lors de la mise en forme des permilles.
NumeralSystem	Obtient ou définit le système de numérotation utilisé pour mettre en forme et analyser les valeurs parmille.
ResolvedGeographicRegion	Obtient la région géographique qui a été utilisée le plus récemment pour mettre en forme ou analyser des valeurs permille.
ResolvedLanguage	Obtient la langue qui a été utilisée le plus récemment pour mettre en forme ou analyser les valeurs permille.
SignificantDigits	Obtient ou définit le remplissage actuel sur des chiffres significatifs lorsqu’un permille est mis en forme.

Méthodes

Format(Double)	Retourne une représentation sous forme de chaîne d’un permillage double .
Format(Int64)	Retourne une représentation sous forme de chaîne d’un permillage Int64 .
Format(UInt64)	Retourne une représentation sous forme de chaîne d’un permillage UInt64 .
FormatDouble(Double)	Retourne une représentation sous forme de chaîne d’un permillage double .
FormatInt(Int64)	Retourne une représentation sous forme de chaîne d’un permillage Int64 .
FormatUInt(UInt64)	Retourne une représentation sous forme de chaîne d’un permillage UInt64 .
ParseDouble(String)	Tente d’analyser une représentation sous forme de chaîne d’un permillage double .
ParseInt(String)	Tente d’analyser une représentation sous forme de chaîne d’un permillage entier.
ParseUInt(String)	Tente d’analyser une représentation sous forme de chaîne d’un permillage entier non signé.

Voir aussi

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Exemple de mise en forme et d’analyse des nombres
• Exemple de mise en forme et d’analyse des nombres (Windows 10)