PermilleFormatter Classe

Definizione

Spazio dei nomi:

Windows.Globalization.NumberFormatting

Formati e analizza permillage.

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

Ereditarietà

Object Platform::Object IInspectable PermilleFormatter

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Nota

Se l'app passa tag di lingua usati in questa classe a qualsiasi funzione di supporto linguistico nazionale, deve prima convertire i tag chiamando ResolveLocaleName.

Costruttori

PermilleFormatter()	Crea un oggetto PermilleFormatter e lo inizializza in valori predefiniti.
PermilleFormatter(IIterable<String>, String)	Crea un oggetto PermilleFormatter inizializzato da un elenco di lingue e da un'area geografica.

Proprietà

FractionDigits	Ottiene o imposta il numero minimo di cifre da visualizzare per la parte frazionaria del permillage.
GeographicRegion	Ottiene l'area usata durante la formattazione e l'analisi dei valori permille.
IntegerDigits	Ottiene o imposta il numero minimo di cifre da visualizzare per la parte integer della permillage.
IsDecimalPointAlwaysDisplayed	Ottiene o imposta se il punto decimale della permillage deve essere sempre visualizzato.
IsGrouped	Ottiene o imposta se la parte integer della permillage deve essere raggruppata.
IsZeroSigned	Ottiene o imposta se -0 è formattato come "-0" o "0".
Languages	Ottiene l'elenco di priorità degli identificatori di lingua usati durante la formattazione e l'analisi dei valori permille.
NumberRounder	Ottiene o imposta la strategia di arrotondamento corrente da usare durante la formattazione delle permille.
NumeralSystem	Ottiene o imposta il sistema di numerazione usato per formattare e analizzare i valori permille.
ResolvedGeographicRegion	Ottiene l'area geografica utilizzata più di recente per formattare o analizzare i valori permille.
ResolvedLanguage	Ottiene la lingua utilizzata più di recente per formattare o analizzare i valori permille.
SignificantDigits	Ottiene o imposta il riempimento corrente su cifre significative quando viene formattato un permille.

Metodi

Format(Double)	Restituisce una rappresentazione di stringa di un doppio permillaggio.
Format(Int64)	Restituisce una rappresentazione di stringa di un oggetto Int64 permillage.
Format(UInt64)	Restituisce una rappresentazione di stringa di un valore UInt64 permillage.
FormatDouble(Double)	Restituisce una rappresentazione di stringa di un doppio permillaggio.
FormatInt(Int64)	Restituisce una rappresentazione di stringa di un oggetto Int64 permillage.
FormatUInt(UInt64)	Restituisce una rappresentazione di stringa di un valore UInt64 permillage.
ParseDouble(String)	Tenta di analizzare una rappresentazione di stringa di un double permillage.
ParseInt(String)	Tenta di analizzare una rappresentazione stringa di un numero intero permillage.
ParseUInt(String)	Tenta di analizzare una rappresentazione stringa di un intero senza segno permillage.

Vedi anche

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Esempio di formattazione e analisi dei numeri
• Esempio di formattazione e analisi dei numeri (Windows 10)