PercentFormatter Clase

Definición

Espacio de nombres:

Windows.Globalization.NumberFormatting

Da formato y analiza porcentajes.

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

Herencia

Object Platform::Object IInspectable PercentFormatter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

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

Comentarios

Nota:

Si la aplicación pasa etiquetas de idioma usadas en esta clase a cualquier función de compatibilidad con lenguaje nacional , primero debe convertir las etiquetas mediante una llamada a ResolveLocaleName.

Constructores

PercentFormatter()	Crea un objeto PercentFormatter e inicializa en valores predeterminados.
PercentFormatter(IIterable<String>, String)	Crea un objeto PercentFormatter inicializado por una lista de idiomas y una región geográfica.

Propiedades

FractionDigits	Obtiene o establece el número mínimo de dígitos que se van a mostrar para la parte de fracción del porcentaje.
GeographicRegion	Obtiene la región que se usa al aplicar formato y analizar porcentajes.
IntegerDigits	Obtiene o establece el número mínimo de dígitos que se van a mostrar para la parte entera del porcentaje.
IsDecimalPointAlwaysDisplayed	Obtiene o establece si siempre se debe mostrar el separador decimal del porcentaje.
IsGrouped	Obtiene o establece si se debe agrupar la parte entera del porcentaje.
IsZeroSigned	Obtiene o establece si -0 tiene el formato "-0" o "0".
Languages	Obtiene la lista de prioridades de los identificadores de idioma que se usan al dar formato y analizar porcentajes.
NumberRounder	Obtiene o establece la estrategia de redondeo actual que se usará al dar formato a porcentajes.
NumeralSystem	Obtiene o establece el sistema de numeración que se usa para dar formato y analizar porcentajes.
ResolvedGeographicRegion	Obtiene la región geográfica que se usó más recientemente para dar formato o analizar los valores de porcentaje.
ResolvedLanguage	Obtiene el idioma que se usó más recientemente para dar formato o analizar los valores de porcentaje.
SignificantDigits	Obtiene o establece el relleno actual en dígitos significativos cuando se da formato a un porcentaje.

Métodos

Format(Double)	Devuelve una representación de cadena de un porcentaje double .
Format(Int64)	Devuelve una representación de cadena de un porcentaje int64 .
Format(UInt64)	Devuelve una representación de cadena de un porcentaje UInt64 .
FormatDouble(Double)	Devuelve una representación de cadena de un porcentaje double .
FormatInt(Int64)	Devuelve una representación de cadena de un porcentaje int64 .
FormatUInt(UInt64)	Devuelve una representación de cadena de un porcentaje UInt64 .
ParseDouble(String)	Intenta analizar una representación de cadena de un porcentaje double .
ParseInt(String)	Intenta analizar una representación de cadena de un porcentaje entero.
ParseUInt(String)	Intenta analizar una representación de cadena de un porcentaje entero sin signo.

Consulte también

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Ejemplo de análisis y formato de números
• Ejemplo de formato y análisis de números (Windows 10)