PermilleFormatter Classe

Definição

Namespace:

Windows.Globalization.NumberFormatting

Formatos e análises 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

Herança

Object Platform::Object IInspectable PermilleFormatter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

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

Comentários

Observação

Se seu aplicativo passar marcas de idioma usadas nessa classe para qualquer função de Suporte à Linguagem Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

Construtores

PermilleFormatter()	Cria um objeto PermilleFormatter e o inicializa para valores padrão.
PermilleFormatter(IIterable<String>, String)	Cria um objeto PermilleFormatter inicializado por uma lista de idiomas e uma região geográfica.

Propriedades

FractionDigits	Obtém ou define o número mínimo de dígitos a serem exibidos para a parte de fração da permillage.
GeographicRegion	Obtém a região usada ao formatar e analisar valores permille.
IntegerDigits	Obtém ou define o número mínimo de dígitos a serem exibidos para a parte inteira da permillage.
IsDecimalPointAlwaysDisplayed	Obtém ou define se o ponto decimal da permillage sempre deve ser exibido.
IsGrouped	Obtém ou define se a parte inteira da permillage deve ser agrupada.
IsZeroSigned	Obtém ou define se -0 está formatado como "-0" ou "0".
Languages	Obtém a lista de prioridades de identificadores de idioma usados ao formatar e analisar valores permille.
NumberRounder	Obtém ou define a estratégia de arredondamento atual a ser usada ao formatar permilles.
NumeralSystem	Obtém ou define o sistema de numeração usado para formatar e analisar valores permille.
ResolvedGeographicRegion	Obtém a região geográfica que foi usada mais recentemente para formatar ou analisar valores permille.
ResolvedLanguage	Obtém o idioma que foi usado mais recentemente para formatar ou analisar valores permille.
SignificantDigits	Obtém ou define o preenchimento atual como dígitos significativos quando um permille é formatado.

Métodos

Format(Double)	Retorna uma representação de cadeia de caracteres de uma permillage Double .
Format(Int64)	Retorna uma representação de cadeia de caracteres de uma permillage Int64 .
Format(UInt64)	Retorna uma representação de cadeia de caracteres de uma permillage UInt64 .
FormatDouble(Double)	Retorna uma representação de cadeia de caracteres de uma permillage Double .
FormatInt(Int64)	Retorna uma representação de cadeia de caracteres de uma permillage Int64 .
FormatUInt(UInt64)	Retorna uma representação de cadeia de caracteres de uma permillage UInt64 .
ParseDouble(String)	Tenta analisar uma representação de cadeia de caracteres de uma permillage Double .
ParseInt(String)	Tenta analisar uma representação de cadeia de caracteres de um inteiro permillage.
ParseUInt(String)	Tenta analisar uma representação de cadeia de caracteres de uma permillage inteiro sem sinal.

Confira também

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Exemplo de formatação de número e análise
• Exemplo de formatação e análise de número (Windows 10)