NumberFormatInfo.CurrencyDecimalDigits Propriedade

Definição

Obtém ou define o número de casas decimais a ser usado em valores de moeda.

public:
 property int CurrencyDecimalDigits { int get(); void set(int value); };
public int CurrencyDecimalDigits { get; set; }
member this.CurrencyDecimalDigits : int with get, set
Public Property CurrencyDecimalDigits As Integer

Valor da propriedade

O número de casas decimais a ser usado em valores de moeda. O padrão para InvariantInfo é 2.

Exceções

A propriedade está sendo definida como um valor menor que 0 ou maior que 99.

A propriedade está sendo definida e o objeto NumberFormatInfo é somente leitura.

Exemplos

O exemplo a seguir demonstra o efeito da alteração da CurrencyDecimalDigits propriedade.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Gets a NumberFormatInfo associated with the en-US culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   NumberFormatInfo^ nfi = MyCI->NumberFormat;
   
   // Displays a negative value with the default number of decimal digits (2).
   Int64 myInt = -1234;
   Console::WriteLine( myInt.ToString( "C", nfi ) );
   
   // Displays the same value with four decimal digits.
   nfi->CurrencyDecimalDigits = 4;
   Console::WriteLine( myInt.ToString( "C", nfi ) );
}

/* 
This code produces the following output.

($1, 234.00)
($1, 234.0000)
*/
using System;
using System.Globalization;

class NumberFormatInfoSample {

   public static void Main() {

      // Gets a NumberFormatInfo associated with the en-US culture.
      NumberFormatInfo nfi = new CultureInfo( "en-US", false ).NumberFormat;

      // Displays a negative value with the default number of decimal digits (2).
      Int64 myInt = -1234;
      Console.WriteLine( myInt.ToString( "C", nfi ) );

      // Displays the same value with four decimal digits.
      nfi.CurrencyDecimalDigits = 4;
      Console.WriteLine( myInt.ToString( "C", nfi ) );
   }
}


/*
This code produces the following output.

($1,234.00)
($1,234.0000)
*/
Imports System.Globalization

Class NumberFormatInfoSample

   Public Shared Sub Main()

      ' Gets a NumberFormatInfo associated with the en-US culture.
      Dim nfi As NumberFormatInfo = New CultureInfo("en-US", False).NumberFormat

      ' Displays a negative value with the default number of decimal digits (2).
      Dim myInt As Int64 = - 1234
      Console.WriteLine(myInt.ToString("C", nfi))

      ' Displays the same value with four decimal digits.
      nfi.CurrencyDecimalDigits = 4
      Console.WriteLine(myInt.ToString("C", nfi))

   End Sub

End Class


' This code produces the following output.
'
' ($1,234.00)
' ($1,234.0000)

Comentários

A CurrencyDecimalDigits propriedade é usada com a cadeia de caracteres de formato padrão "C" sem um especificador de precisão em operações de formatação numérica. Ele define o número padrão de dígitos fracionários que aparecem após o separador decimal. Esse valor será substituído se um especificador de precisão for usado. Para obter mais informações, confira Cadeias de caracteres de formato numérico padrão.

Aplica-se a

Confira também