NumberFormatInfo Classe

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

NumberFormatInfo.cs

Fornece informações específicas da cultura para formatação e análise de valores numéricos.

public ref class NumberFormatInfo sealed : ICloneable, IFormatProvider

public sealed class NumberFormatInfo : ICloneable, IFormatProvider

type NumberFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class NumberFormatInfo
Implements ICloneable, IFormatProvider

Herança

Object

NumberFormatInfo

Implementações

IFormatProvider ICloneable

Exemplos

O exemplo a seguir mostra como recuperar um NumberFormatInfo objeto para um objeto correspondente CultureInfo e usar o objeto recuperado para consultar informações de formatação de número para a cultura específica.

using namespace System;
using namespace System::Globalization;
using namespace System::Text;

int main()
{
    StringBuilder^ builder = gcnew StringBuilder();

    // Loop through all the specific cultures known to the CLR.
    for each(CultureInfo^ culture in 
        CultureInfo::GetCultures (CultureTypes::SpecificCultures)) 
    {
        // Only show the currency symbols for cultures 
        // that speak English.
        if (culture->TwoLetterISOLanguageName == "en")
        {
            // Display the culture name and currency symbol.
            NumberFormatInfo^ numberFormat = culture->NumberFormat;
            builder->AppendFormat("The currency symbol for '{0}'"+
                "is '{1}'",culture->DisplayName,
                numberFormat->CurrencySymbol);
            builder->AppendLine();
        }
    }
    Console::WriteLine(builder);
}

// This code produces the following output.
//
// The currency symbol for 'English (United States)' is '$'
// The currency symbol for 'English (United Kingdom)' is 'Ј'
// The currency symbol for 'English (Australia)' is '$'
// The currency symbol for 'English (Canada)' is '$'
// The currency symbol for 'English (New Zealand)' is '$'
// The currency symbol for 'English (Ireland)' is '?'
// The currency symbol for 'English (South Africa)' is 'R'
// The currency symbol for 'English (Jamaica)' is 'J$'
// The currency symbol for 'English (Caribbean)' is '$'
// The currency symbol for 'English (Belize)' is 'BZ$'
// The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
// The currency symbol for 'English (Zimbabwe)' is 'Z$'
// The currency symbol for 'English (Republic of the Philippines)' is 'Php'

using System;
using System.Globalization;
using System.Text;

public sealed class App
{
    static void Main()
    {
        StringBuilder sb = new StringBuilder();

        // Loop through all the specific cultures known to the CLR.
        foreach (CultureInfo ci in CultureInfo.GetCultures(CultureTypes.SpecificCultures))
        {
            // Only show the currency symbols for cultures that speak English.
            if (ci.TwoLetterISOLanguageName != "en") continue;

            // Display the culture name and currency symbol.
            NumberFormatInfo nfi = ci.NumberFormat;
            sb.AppendFormat("The currency symbol for '{0}' is '{1}'",
                ci.DisplayName, nfi.CurrencySymbol);
            sb.AppendLine();
        }
        Console.WriteLine(sb.ToString());
    }
}

// This code produces the following output.
//
// The currency symbol for 'English (United States)' is '$'
// The currency symbol for 'English (United Kingdom)' is '£'
// The currency symbol for 'English (Australia)' is '$'
// The currency symbol for 'English (Canada)' is '$'
// The currency symbol for 'English (New Zealand)' is '$'
// The currency symbol for 'English (Ireland)' is '?'
// The currency symbol for 'English (South Africa)' is 'R'
// The currency symbol for 'English (Jamaica)' is 'J$'
// The currency symbol for 'English (Caribbean)' is '$'
// The currency symbol for 'English (Belize)' is 'BZ$'
// The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
// The currency symbol for 'English (Zimbabwe)' is 'Z$'
// The currency symbol for 'English (Republic of the Philippines)' is 'Php'

Imports System.Globalization
Imports System.Text

Public Module Example
   Public Sub Main() 
      Dim sb As New StringBuilder()

      ' Loop through all the specific cultures known to the CLR.
      For Each ci In CultureInfo.GetCultures(CultureTypes.SpecificCultures) 
         ' Only show the currency symbols for cultures that speak English.
         If ci.TwoLetterISOLanguageName <> "en" Then Continue For

         ' Display the culture name and currency symbol.
         Dim nfi As NumberFormatInfo = ci.NumberFormat
         sb.AppendFormat("The currency symbol for '{0}' is '{1}'",
                         ci.DisplayName, nfi.CurrencySymbol)
         sb.AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays output like the following:
'       The currency symbol for 'English (United States)' is '$'
'       The currency symbol for 'English (United Kingdom)' is '£'
'       The currency symbol for 'English (Australia)' is '$'
'       The currency symbol for 'English (Canada)' is '$'
'       The currency symbol for 'English (New Zealand)' is '$'
'       The currency symbol for 'English (Ireland)' is '?'
'       The currency symbol for 'English (South Africa)' is 'R'
'       The currency symbol for 'English (Jamaica)' is 'J$'
'       The currency symbol for 'English (Caribbean)' is '$'
'       The currency symbol for 'English (Belize)' is 'BZ$'
'       The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
'       The currency symbol for 'English (Zimbabwe)' is 'Z$'
'       The currency symbol for 'English (Republic of the Philippines)' is 'Php'
'       The currency symbol for 'English (India)' is 'Rs.'
'       The currency symbol for 'English (Malaysia)' is 'RM'
'       The currency symbol for 'English (Singapore)' is '$'

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API suplementares para NumberFormatInfo.

Construtores

NumberFormatInfo()

Inicializa uma nova instância gravável da classe NumberFormatInfo que é independente da cultura (invariável).

Propriedades

CurrencyDecimalDigits	Obtém ou define o número de casas decimais a ser usado em valores de moeda.
CurrencyDecimalSeparator	Obtém ou define a cadeia de caracteres a ser usada como separador decimal em valores de moeda.
CurrencyGroupSeparator	Obtém ou define a cadeia de caracteres que separa grupos de dígitos à esquerda do decimal em valores de moeda.
CurrencyGroupSizes	Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores de moeda.
CurrencyNegativePattern	Obtém ou define o padrão de formato para valores negativos de moeda.
CurrencyPositivePattern	Obtém ou define o padrão de formato para valores positivos de moeda.
CurrencySymbol	Obtém ou define a cadeia de caracteres a ser usada como o símbolo de moeda.
CurrentInfo	Obtém o NumberFormatInfo somente leitura que formata valores com base na cultura atual.
DigitSubstitution	Obtém ou define um valor que especifica como a interface gráfica do usuário exibe a forma de um dígito.
InvariantInfo	Obtém o objeto NumberFormatInfo somente leitura que é independente da cultura (invariável).
IsReadOnly	Obtém um valor que indica se este objeto NumberFormatInfo é somente leitura.
NaNSymbol	Obtém ou define a cadeia de caracteres que representa o valor de IEEE NaN (não é um número).
NativeDigits	Obtém ou define uma matriz de cadeia de caracteres de dígitos nativos equivalentes aos dígitos ocidentais de 0 a 9.
NegativeInfinitySymbol	Obtém ou define a cadeia de caracteres que representa o infinito negativo.
NegativeSign	Obtém ou define a cadeia de caracteres que indica que o número associado é negativo.
NumberDecimalDigits	Obtém ou define o número de casas decimais a ser usado em valores numéricos.
NumberDecimalSeparator	Obtém ou define a cadeia de caracteres a ser usada como separador decimal em valores numéricos.
NumberGroupSeparator	Obtém ou define a cadeia de caracteres que separa grupos de dígitos à esquerda da vírgula decimal em valores numéricos.
NumberGroupSizes	Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores numéricos.
NumberNegativePattern	Obtém ou define o padrão de formato para valores numéricos negativos.
PercentDecimalDigits	Obtém ou define o número de casas decimais a ser usado em valores percentuais.
PercentDecimalSeparator	Obtém ou define a cadeia de caracteres a ser usada como o separador decimal em valores de porcentagem.
PercentGroupSeparator	Obtém ou define a cadeia de caracteres que separa os grupos de dígitos à esquerda do separador decimal em valores de percentual.
PercentGroupSizes	Obtém ou define o número de dígitos em cada grupo à esquerda do decimal em valores percentuais.
PercentNegativePattern	Obtém ou define o padrão de formato dos valores percentuais negativos.
PercentPositivePattern	Obtém ou define o padrão de formato para valores percentuais positivos.
PercentSymbol	Obtém ou define a cadeia de caracteres a ser usada como o símbolo de porcentagem.
PerMilleSymbol	Obtém ou define a cadeia de caracteres a ser usada como o símbolo por milha.
PositiveInfinitySymbol	Obtém ou define a cadeia de caracteres que representa o infinito positivo.
PositiveSign	Obtém ou define a cadeia de caracteres que indica que o número associado é positivo.

Métodos

Clone()	Cria uma cópia superficial do objeto NumberFormatInfo.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetFormat(Type)	Obtém um objeto do tipo especificado que fornece um serviço de formatação de número.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetInstance(IFormatProvider)	Obtém o NumberFormatInfo associado ao IFormatProvider especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ReadOnly(NumberFormatInfo)	Retorna um wrapper NumberFormatInfo de somente leitura.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• CultureInfo
• IFormatProvider
• Cadeias de caracteres de formato numérico personalizado