NumberFormatInfo Classe

Definição

Fornece informação específica por cultura para formatação e análise de valores numéricos.

public ref class NumberFormatInfo sealed : IFormatProvider
public ref class NumberFormatInfo sealed : ICloneable, IFormatProvider
public sealed class NumberFormatInfo : IFormatProvider
public sealed class NumberFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
public sealed class NumberFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NumberFormatInfo : ICloneable, IFormatProvider
type NumberFormatInfo = class
    interface IFormatProvider
type NumberFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type NumberFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NumberFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class NumberFormatInfo
Implements IFormatProvider
Public NotInheritable Class NumberFormatInfo
Implements ICloneable, IFormatProvider
Herança
NumberFormatInfo
Atributos
Implementações

Observações

Para mais informações sobre esta API, consulte Observações Suplementares da API para o NumberFormatInfo.

Example

O exemplo seguinte mostra como recuperar um NumberFormatInfo objeto para um objeto correspondente CultureInfo e usar o objeto recuperado para consultar informação de formatação de números para a cultura em particular.

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 '$'

Construtores

Name Description
NumberFormatInfo()

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

Propriedades

Name Description
CurrencyDecimalDigits

Obtém ou define o número de casas decimais a usar nos valores da moeda.

CurrencyDecimalSeparator

Obtém ou define a cadeia para ser usada como separador decimal nos valores da moeda.

CurrencyGroupSeparator

Obtém ou define a cadeia que separa grupos de dígitos à esquerda do decimal nos valores da moeda.

CurrencyGroupSizes

Obtém ou define o número de dígitos em cada grupo à esquerda do decimal nos valores da moeda.

CurrencyNegativePattern

Obtém ou define o padrão de formato para valores monetários negativos.

CurrencyPositivePattern

Obtém ou define o padrão de formato para valores monetários positivos.

CurrencySymbol

Recebe ou define a corda para usar como símbolo de moeda.

CurrentInfo

Recebe um modo somente NumberFormatInfo de leitura que formata os valores com base na cultura atual.

DigitSubstitution

Recebe ou define um valor que especifica como a interface gráfica do utilizador mostra a forma de um dígito.

InvariantInfo

Obtém um objeto apenas NumberFormatInfo de leitura que é independente da cultura (invariante).

IsReadOnly

Obtém um valor que indica se este NumberFormatInfo objeto é apenas leitura.

NaNSymbol

Recebe ou define a cadeia que representa o valor IEEE NaN (não um número).

NativeDigits

Obtém ou estabelece um array de cadeias de dígitos nativos equivalentes aos dígitos ocidentais de 0 a 9.

NegativeInfinitySymbol

Obtém ou define a cadeia que representa o infinito negativo.

NegativeSign

Obtém ou define a cadeia que indica que o número associado é negativo.

NumberDecimalDigits

Obtém ou define o número de casas decimais a usar nos valores numéricos.

NumberDecimalSeparator

Obtém ou define a cadeia para ser usada como separador decimal em valores numéricos.

NumberGroupSeparator

Obtém ou define a cadeia que separa grupos de dígitos à esquerda do 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 usar em valores percentuais.

PercentDecimalSeparator

Obtém ou define a cadeia para ser usada como separador decimal em valores percentuais.

PercentGroupSeparator

Obtém ou define a cadeia que separa grupos de dígitos à esquerda do decimal em valores percentuais.

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 para valores percentuais negativos.

PercentPositivePattern

Obtém ou define o padrão de formato para valores percentuais positivos.

PercentSymbol

Obtém ou define a cadeia para usar como símbolo percentual.

PerMilleSymbol

Obtém ou define a corda para usar como símbolo per mille.

PositiveInfinitySymbol

Obtém ou define a cadeia que representa o infinito positivo.

PositiveSign

Obtém ou define a cadeia que indica que o número associado é positivo.

Métodos

Name Description
Clone()

Cria uma cópia superficial do NumberFormatInfo objeto.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetFormat(Type)

Recebe um objeto do tipo especificado que fornece um serviço de formatação numérica.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetInstance(IFormatProvider)

Obtém o NumberFormatInfo associado ao especificado IFormatProvider.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ReadOnly(NumberFormatInfo)

Devolve uma embalagem de apenas NumberFormatInfo leitura.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também