Ler em inglês

Partilhar via


Decimal.ToUInt64(Decimal) Método

Definição

Importante

Esta API não está em conformidade com CLS.

Converte o valor do Decimal especificado no inteiro sem sinal de 64 bits equivalente.

C#
[System.CLSCompliant(false)]
public static ulong ToUInt64(decimal d);

Parâmetros

d
Decimal

O número decimal a ser convertido.

Retornos

Um inteiro sem sinal de 64 bits equivalente ao valor de d.

Atributos

Exceções

d é negativo ou maior que UInt64.MaxValue.

Exemplos

O exemplo a seguir usa o ToUInt64 método para converter números decimais em UInt64 valores.

C#
using System;

class Example
{
   public static void Main( )
   {
      decimal[] values = { 123m, new Decimal(123000, 0, 0, false, 3),
                           123.999m, 18446744073709551615.999m,
                           18446744073709551616m, 9223372036854775807.999m,
                           9223372036854775808m, -0.999m, -1m,
                           -9223372036854775808.999m,
                           -9223372036854775809m };

      foreach (var value in values) {
         try {
            ulong number = Decimal.ToUInt64(value);
            Console.WriteLine("{0} --> {1}", value, number);
         }
         catch (OverflowException e)
         {
             Console.WriteLine("{0}: {1}", e.GetType().Name, value);
         }
      }
   }
}
// The example displays the following output:
//     123 --> 123
//     123.000 --> 123
//     123.999 --> 123
//     18446744073709551615.999 --> 18446744073709551615
//     OverflowException: 18446744073709551616
//     9223372036854775807.999 --> 9223372036854775807
//     9223372036854775808 --> 9223372036854775808
//     -0.999 --> 0
//     OverflowException: -1
//     OverflowException: -9223372036854775808.999
//     OverflowException: -9223372036854775809

Comentários

O valor de retorno é a parte integral do valor decimal; os dígitos fracionários são truncados.

Você também pode converter um Decimal valor em um inteiro sem sinal de 64 bits usando o Explicit operador de atribuição. Como o operador executa uma conversão de restrição, você deve usar um operador de conversão em C# ou uma função de conversão no Visual Basic.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Confira também