PercentFormatter Classe

Definizione

Spazio dei nomi:

Windows.Globalization.NumberFormatting

Formatta e analizza le percentuali.

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

Ereditarietà

Object Platform::Object IInspectable PercentFormatter

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 per il linguaggio nazionale , deve prima convertire i tag chiamando ResolveLocaleName.

Costruttori

PercentFormatter()	Crea un oggetto PercentFormatter e lo inizializza in valori predefiniti.
PercentFormatter(IIterable<String>, String)	Crea un oggetto PercentFormatter 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 della percentuale.
GeographicRegion	Ottiene l'area utilizzata per la formattazione e l'analisi delle percentuali.
IntegerDigits	Ottiene o imposta il numero minimo di cifre da visualizzare per la parte intera della percentuale.
IsDecimalPointAlwaysDisplayed	Ottiene o imposta un valore che indica se il separatore decimale della percentuale deve essere sempre visualizzato.
IsGrouped	Ottiene o imposta un valore che indica se la parte intera della percentuale deve essere raggruppata.
IsZeroSigned	Ottiene o imposta un valore che indica se -0 è formattato come "-0" o "0".
Languages	Ottiene l'elenco di priorità degli identificatori di lingua utilizzati durante la formattazione e l'analisi delle percentuali.
NumberRounder	Ottiene o imposta la strategia di arrotondamento corrente da utilizzare durante la formattazione delle percentuali.
NumeralSystem	Ottiene o imposta il sistema di numerazione utilizzato per formattare e analizzare le percentuali.
ResolvedGeographicRegion	Ottiene l'area geografica utilizzata più di recente per formattare o analizzare i valori delle percentuali.
ResolvedLanguage	Ottiene la lingua utilizzata più di recente per formattare o analizzare i valori delle percentuali.
SignificantDigits	Ottiene o imposta la spaziatura interna corrente su cifre significative quando viene formattata una percentuale.

Metodi

Format(Double)	Restituisce una rappresentazione di stringa di una percentuale Double .
Format(Int64)	Restituisce una rappresentazione di stringa di una percentuale Int64 .
Format(UInt64)	Restituisce una rappresentazione di stringa di una percentuale UInt64 .
FormatDouble(Double)	Restituisce una rappresentazione di stringa di una percentuale Double .
FormatInt(Int64)	Restituisce una rappresentazione di stringa di una percentuale Int64 .
FormatUInt(UInt64)	Restituisce una rappresentazione di stringa di una percentuale UInt64 .
ParseDouble(String)	Tenta di analizzare una rappresentazione di stringa di una percentuale Double .
ParseInt(String)	Tenta di analizzare una rappresentazione di stringa di una percentuale integer.
ParseUInt(String)	Tenta di analizzare una rappresentazione di stringa di una percentuale integer senza segno.

Vedi anche

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