Decimal Decimal Decimal Decimal Struct

Definição

Representa um número de ponto flutuante decimal.Represents a decimal floating-point number.

public value class Decimal : IComparable, IComparable<System::Decimal>, IConvertible, IEquatable<System::Decimal>, IFormattable, System::Runtime::Serialization::IDeserializationCallback
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Decimal : IComparable, IComparable<decimal>, IConvertible, IEquatable<decimal>, IFormattable, System.Runtime.Serialization.IDeserializationCallback
type decimal = struct
    interface IFormattable
    interface IConvertible
    interface IDeserializationCallback
Public Structure Decimal
Implements IComparable, IComparable(Of Decimal), IConvertible, IDeserializationCallback, IEquatable(Of Decimal), IFormattable
Herança
Atributos
Implementações

Exemplos

O exemplo de código a seguir demonstra o uso de Decimal.The following code example demonstrates the use of Decimal.

   /// <summary>
   /// Keeping my fortune in Decimals to avoid the round-off errors.
   /// </summary>
   public ref class PiggyBank
   {
   protected:
      Decimal MyFortune;

   public:
      void AddPenny()
      {
         MyFortune = System::Decimal::Add( MyFortune, Decimal(.01) );
      }

      System::Decimal Capacity()
      {
         return MyFortune.MaxValue;
      }

      Decimal Dollars()
      {
         return Decimal::Floor( MyFortune );
      }

      Decimal Cents()
      {
         return Decimal::Subtract( MyFortune, Decimal::Floor( MyFortune ) );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }
   };
}
/// <summary>
/// Keeping my fortune in Decimals to avoid the round-off errors.
/// </summary>
class PiggyBank {
    protected decimal MyFortune;

    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public decimal Capacity {
        get {
            return Decimal.MaxValue;
        }
    }

    public decimal Dollars {
        get {
            return Decimal.Floor(MyFortune);
        }
    }

    public decimal Cents {
        get {
            return Decimal.Subtract(MyFortune, Decimal.Floor(MyFortune));
        }
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }
}
' Keeping my fortune in Decimals to avoid the round-off errors.
Class PiggyBank
    Protected MyFortune As Decimal

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public ReadOnly Property Capacity() As Decimal
        Get
            Return [Decimal].MaxValue
        End Get
    End Property

    Public ReadOnly Property Dollars() As Decimal
        Get
            Return [Decimal].Floor(MyFortune)
        End Get
    End Property

    Public ReadOnly Property Cents() As Decimal
        Get
            Return [Decimal].Subtract(MyFortune, [Decimal].Floor(MyFortune))
        End Get
    End Property

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function
End Class

Comentários

O Decimal tipo de valor representa números decimais que variam de 79,228,162,514,264,337,593,543,950,335 positivos a 79,228,162,514,264,337,593,543,950,335 negativo.The Decimal value type represents decimal numbers ranging from positive 79,228,162,514,264,337,593,543,950,335 to negative 79,228,162,514,264,337,593,543,950,335. O valor padrão de a Decimal é 0.The default value of a Decimal is 0. O Decimal tipo de valor é apropriado para cálculos financeiros que exigem um grande número de dígitos inteiros e fracionários significativos e nenhum erro de arredondamento.The Decimal value type is appropriate for financial calculations that require large numbers of significant integral and fractional digits and no round-off errors. O Decimal tipo não elimina a necessidade de arredondamento.The Decimal type does not eliminate the need for rounding. Em vez disso, ele minimiza erros devido a arredondamento.Rather, it minimizes errors due to rounding. Por exemplo, o código a seguir produz um resultado de 0.9999999999999999999999999999 em vez de 1.For example, the following code produces a result of 0.9999999999999999999999999999 instead of 1.

using namespace System;

void main()
{
   Decimal dividend = Decimal::One;
   Decimal divisor = 3;
   // The following displays 0.9999999999999999999999999999 to the console
   Console::WriteLine(dividend/divisor * divisor);   
}
decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 0.9999999999999999999999999999 to the console
Console.WriteLine(dividend/divisor * divisor);   
Dim dividend As Decimal = Decimal.One
Dim divisor As Decimal = 3
' The following displays 0.9999999999999999999999999999 to the console
Console.WriteLine(dividend/divisor * divisor)   

Quando o resultado da divisão e multiplicação é passado para o Round método, o resultado não sofre perda de precisão, como mostra o código a seguir.When the result of the division and multiplication is passed to the Round method, the result suffers no loss of precision, as the following code shows.

using namespace System;


void main()
{
   Decimal dividend = Decimal::One;
   Decimal divisor = 3;
   // The following displays 1.00 to the console
   Console::WriteLine(Math::Round(dividend/divisor * divisor, 2));   	
}
decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 1.00 to the console
Console.WriteLine(Math.Round(dividend/divisor * divisor, 2));   
Dim dividend As Decimal = Decimal.One
Dim divisor As Decimal = 3
' The following displays 1.00 to the console
Console.WriteLine(Math.Round(dividend/divisor * divisor, 2))   

Um número decimal é um valor de ponto flutuante que consiste em um sinal, um valor numérico em que cada dígito no valor varia de 0 a 9 e um fator de dimensionamento que indica a posição de um ponto decimal flutuante que separa as partes integral e fracionária do valor numérico.A decimal number is a floating-point value that consists of a sign, a numeric value where each digit in the value ranges from 0 to 9, and a scaling factor that indicates the position of a floating decimal point that separates the integral and fractional parts of the numeric value.

A representação binária de um Decimal valor consiste em um sinal de 1 bit, um número inteiro de 96 bits e um fator de dimensionamento usado para dividir o inteiro de 96 bits e especificar qual parte dele é uma fração decimal.The binary representation of a Decimal value consists of a 1-bit sign, a 96-bit integer number, and a scaling factor used to divide the 96-bit integer and specify what portion of it is a decimal fraction. O fator de dimensionamento é implicitamente o número 10, elevado a um expoente que varia de 0 a 28.The scaling factor is implicitly the number 10, raised to an exponent ranging from 0 to 28. Portanto, a representação binária de um Decimal valor do formulário ((-296 a 296)/10(0 a 28)), onde-(296-1) é igual MinValuea e 296-1 é igual a MaxValue.Therefore, the binary representation of a Decimal value the form, ((-296 to 296) / 10(0 to 28)), where -(296-1) is equal to MinValue, and 296-1 is equal to MaxValue. Para obter mais informações sobre a representação binária Decimal de valores e um exemplo, consulte Decimal(Int32[]) o construtor e GetBits o método.For more information about the binary representation of Decimal values and an example, see the Decimal(Int32[]) constructor and the GetBits method.

O fator de dimensionamento também preserva os zeros à direita em um Decimal número.The scaling factor also preserves any trailing zeros in a Decimal number. Zeros à direita não afetam o valor de um Decimal número em operações aritméticas ou de comparação.Trailing zeros do not affect the value of a Decimal number in arithmetic or comparison operations. No entanto, os ToString zeros à direita podem ser revelados pelo método se uma cadeia de caracteres de formato apropriada for aplicada.However, trailing zeros might be revealed by the ToString method if an appropriate format string is applied.

Considerações de conversãoConversion Considerations

Esse tipo fornece métodos que convertem Decimal valores de Int64 SBytee para Int16valores Int32 Byte UInt64 ,, UInt16 UInt32,,,, e.This type provides methods that convert Decimal values to and from SByte, Int16, Int32, Int64, Byte, UInt16, UInt32, and UInt64 values. As conversões desses tipos Decimal integrais estão ampliando conversões que nunca perdem informações ou geram exceções.Conversions from these integral types to Decimal are widening conversions that never lose information or throw exceptions.

As conversões de Decimal para qualquer um dos tipos integrais estão restringindo conversões que arredondam o Decimal valor para o valor inteiro mais próximo em direção a zero.Conversions from Decimal to any of the integral types are narrowing conversions that round the Decimal value to the nearest integer value toward zero. Alguns idiomas, como C#, também oferecem suporte à conversão de Decimal valores em Char valores.Some languages, such as C#, also support the conversion of Decimal values to Char values. Se o resultado dessas conversões não puder ser representado no tipo de destino, uma OverflowException exceção será lançada.If the result of these conversions cannot be represented in the destination type, an OverflowException exception is thrown.

O Decimal tipo também fornece métodos que convertem Decimal Double valores de e Single para valores.The Decimal type also provides methods that convert Decimal values to and from Single and Double values. Conversões de Decimal Single ou Double são conversões estreitas que podem perder precisão, mas não informações sobre a magnitude do valor convertido.Conversions from Decimal to Single or Double are narrowing conversions that might lose precision but not information about the magnitude of the converted value. A conversão não gera uma exceção.The conversion does not throw an exception.

Single Conversões de Decimalou Double para Decimal gerar uma OverflowException exceção se o resultado da conversão não puder ser representado como um.Conversions from Single or Double to Decimal throw an OverflowException exception if the result of the conversion cannot be represented as a Decimal.

Realizando operações em valores decimaisPerforming Operations on Decimal Values

O Decimal tipo dá suporte a operações matemáticas padrão, como adição, subtração, divisão, multiplicação e negação unário.The Decimal type supports standard mathematical operations such as addition, subtraction, division, multiplication, and unary negation. Você também pode trabalhar diretamente com a representação binária de um Decimal valor chamando o GetBits método.You can also work directly with the binary representation of a Decimal value by calling the GetBits method.

Para comparar dois Decimal valores, você pode usar os operadores de comparação numéricos padrão ou pode chamar o CompareTo método Equals ou.To compare two Decimal values, you can use the standard numeric comparison operators, or you can call the CompareTo or Equals method.

Você também pode chamar os membros da Math classe para executar uma ampla variedade de operações numéricas, incluindo obter o valor absoluto de um número, determinando o valor máximo ou mínimo de dois Decimal valores, obtendo o sinal de um número e arredondando um número.You can also call the members of the Math class to perform a wide range of numeric operations, including getting the absolute value of a number, determining the maximum or minimum value of two Decimal values, getting the sign of a number, and rounding a number.

Construtores

Decimal(Double) Decimal(Double) Decimal(Double) Decimal(Double)

Inicializa uma nova instância de Decimal para o valor do número de ponto flutuante especificado de precisão dupla.Initializes a new instance of Decimal to the value of the specified double-precision floating-point number.

Decimal(Int32) Decimal(Int32) Decimal(Int32) Decimal(Int32)

Inicializa uma nova instância de Decimal para o valor inteiro com sinal de 32 bits especificado.Initializes a new instance of Decimal to the value of the specified 32-bit signed integer.

Decimal(Int32[]) Decimal(Int32[]) Decimal(Int32[]) Decimal(Int32[])

Inicializa uma nova instância de Decimal para um valor decimal representado no binário e contido em uma matriz especificada.Initializes a new instance of Decimal to a decimal value represented in binary and contained in a specified array.

Decimal(Int64) Decimal(Int64) Decimal(Int64) Decimal(Int64)

Inicializa uma nova instância de Decimal para o valor inteiro com sinal de 64 bits especificado.Initializes a new instance of Decimal to the value of the specified 64-bit signed integer.

Decimal(Single) Decimal(Single) Decimal(Single) Decimal(Single)

Inicializa uma nova instância de Decimal para o valor do número de ponto flutuante especificado de precisão simples.Initializes a new instance of Decimal to the value of the specified single-precision floating-point number.

Decimal(UInt32) Decimal(UInt32) Decimal(UInt32) Decimal(UInt32)

Inicializa uma nova instância de Decimal para o valor inteiro sem sinal de 32 bits especificado.Initializes a new instance of Decimal to the value of the specified 32-bit unsigned integer.

Decimal(UInt64) Decimal(UInt64) Decimal(UInt64) Decimal(UInt64)

Inicializa uma nova instância de Decimal para o valor inteiro sem sinal de 64 bits especificado.Initializes a new instance of Decimal to the value of the specified 64-bit unsigned integer.

Decimal(Int32, Int32, Int32, Boolean, Byte) Decimal(Int32, Int32, Int32, Boolean, Byte) Decimal(Int32, Int32, Int32, Boolean, Byte) Decimal(Int32, Int32, Int32, Boolean, Byte)

Inicializa uma nova instância de Decimal de parâmetros que especificam as partes constituintes da instância.Initializes a new instance of Decimal from parameters specifying the instance's constituent parts.

Campos

MaxValue MaxValue MaxValue MaxValue

Representa o maior valor possível de Decimal.Represents the largest possible value of Decimal. Este campo é constante e somente leitura.This field is constant and read-only.

MinusOne MinusOne MinusOne MinusOne

Representa o número um negativo (-1).Represents the number negative one (-1).

MinValue MinValue MinValue MinValue

Representa o menor valor possível de Decimal.Represents the smallest possible value of Decimal. Este campo é constante e somente leitura.This field is constant and read-only.

One One One One

Representa o número um (1).Represents the number one (1).

Zero Zero Zero Zero

Representa o número zero (0).Represents the number zero (0).

Métodos

Add(Decimal, Decimal) Add(Decimal, Decimal) Add(Decimal, Decimal) Add(Decimal, Decimal)

Soma dois valores Decimal especificados.Adds two specified Decimal values.

Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal) Ceiling(Decimal)

Retorna o menor valor integral maior ou igual ao número decimal especificado.Returns the smallest integral value that is greater than or equal to the specified decimal number.

Compare(Decimal, Decimal) Compare(Decimal, Decimal) Compare(Decimal, Decimal) Compare(Decimal, Decimal)

Compara dois valores Decimal especificados.Compares two specified Decimal values.

CompareTo(Decimal) CompareTo(Decimal) CompareTo(Decimal) CompareTo(Decimal)

Compara essa instância com um objeto Decimal especificado e retorna uma comparação dos valores relativos.Compares this instance to a specified Decimal object and returns a comparison of their relative values.

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

Compara essa instância com um objeto especificado e retorna uma comparação dos valores relativos.Compares this instance to a specified object and returns a comparison of their relative values.

Divide(Decimal, Decimal) Divide(Decimal, Decimal) Divide(Decimal, Decimal) Divide(Decimal, Decimal)

Divide dois valores Decimal especificados.Divides two specified Decimal values.

Equals(Decimal) Equals(Decimal) Equals(Decimal) Equals(Decimal)

Retorna um valor que indica se essa instância e um objeto Decimal especificado representam o mesmo valor.Returns a value indicating whether this instance and a specified Decimal object represent the same value.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Retorna um valor que indica se essa instância e um Object especificado representam o mesmo tipo de valor.Returns a value indicating whether this instance and a specified Object represent the same type and value.

Equals(Decimal, Decimal) Equals(Decimal, Decimal) Equals(Decimal, Decimal) Equals(Decimal, Decimal)

Retorna um valor que indica se duas instâncias especificadas de Decimal representam o mesmo valor.Returns a value indicating whether two specified instances of Decimal represent the same value.

Floor(Decimal) Floor(Decimal) Floor(Decimal) Floor(Decimal)

Arredonda um número Decimal especificado para o inteiro mais próximo do infinito negativo.Rounds a specified Decimal number to the closest integer toward negative infinity.

FromOACurrency(Int64) FromOACurrency(Int64) FromOACurrency(Int64) FromOACurrency(Int64)

Converte inteiro com sinal de 64 bits, que contém um valor de moeda de Automação de OLE, no valor Decimal equivalente.Converts the specified 64-bit signed integer, which contains an OLE Automation Currency value, to the equivalent Decimal value.

GetBits(Decimal) GetBits(Decimal) GetBits(Decimal) GetBits(Decimal)

Converte o valor da instância especificada de Decimal para sua representação de cadeia de caracteres equivalente.Converts the value of a specified instance of Decimal to its equivalent binary representation.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retorna o código hash para essa instância.Returns the hash code for this instance.

GetTypeCode() GetTypeCode() GetTypeCode() GetTypeCode()

Retorna o TypeCode para tipo de valor Decimal.Returns the TypeCode for value type Decimal.

Multiply(Decimal, Decimal) Multiply(Decimal, Decimal) Multiply(Decimal, Decimal) Multiply(Decimal, Decimal)

Multiplica dois valores Decimal especificados.Multiplies two specified Decimal values.

Negate(Decimal) Negate(Decimal) Negate(Decimal) Negate(Decimal)

Retorna o resultado da multiplicação do valor Decimal especificado pelo negativo.Returns the result of multiplying the specified Decimal value by negative one.

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando o formato específico da cultura e estilo especificados.Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Converte a representação de cadeia de caracteres de um número no equivalente de Decimal usando as informações de formato específicas da cultura especificadas.Converts the string representation of a number to its Decimal equivalent using the specified culture-specific format information.

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Converte a representação de cadeia de caracteres de um número em um estilo especificado em seu Decimal equivalente.Converts the string representation of a number in a specified style to its Decimal equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

Converte a representação da cadeia de caracteres de um número no Decimal equivalente.Converts the string representation of a number to its Decimal equivalent.

Remainder(Decimal, Decimal) Remainder(Decimal, Decimal) Remainder(Decimal, Decimal) Remainder(Decimal, Decimal)

Calcula o resto após dividir dois valores Decimal.Computes the remainder after dividing two Decimal values.

Round(Decimal) Round(Decimal) Round(Decimal) Round(Decimal)

Arredonda um valor decimal para o inteiro mais próximo.Rounds a decimal value to the nearest integer.

Round(Decimal, Int32) Round(Decimal, Int32) Round(Decimal, Int32) Round(Decimal, Int32)

Arredonda um valor Decimal para um número especificado de casas decimais.Rounds a Decimal value to a specified number of decimal places.

Round(Decimal, MidpointRounding) Round(Decimal, MidpointRounding) Round(Decimal, MidpointRounding) Round(Decimal, MidpointRounding)

Arredonda um valor decimal para o inteiro mais próximo.Rounds a decimal value to the nearest integer. Um parâmetro especifica como arredondar o valor caso esteja entre dois outros números.A parameter specifies how to round the value if it is midway between two other numbers.

Round(Decimal, Int32, MidpointRounding) Round(Decimal, Int32, MidpointRounding) Round(Decimal, Int32, MidpointRounding) Round(Decimal, Int32, MidpointRounding)

Arredonda um valor decimal para uma precisão especificada.Rounds a decimal value to a specified precision. Um parâmetro especifica como arredondar o valor caso esteja entre dois outros números.A parameter specifies how to round the value if it is midway between two other numbers.

Subtract(Decimal, Decimal) Subtract(Decimal, Decimal) Subtract(Decimal, Decimal) Subtract(Decimal, Decimal)

Subtrai um valor Decimal especificado de outro.Subtracts one specified Decimal value from another.

ToByte(Decimal) ToByte(Decimal) ToByte(Decimal) ToByte(Decimal)

Converte o valor do Decimal especificado no inteiro sem sinal de 8 bits equivalente.Converts the value of the specified Decimal to the equivalent 8-bit unsigned integer.

ToDouble(Decimal) ToDouble(Decimal) ToDouble(Decimal) ToDouble(Decimal)

Converte o valor do Decimal especificado no número de ponto flutuante de precisão dupla equivalente.Converts the value of the specified Decimal to the equivalent double-precision floating-point number.

ToInt16(Decimal) ToInt16(Decimal) ToInt16(Decimal) ToInt16(Decimal)

Converte o valor do Decimal especificado no inteiro com sinal de 16 bits equivalente.Converts the value of the specified Decimal to the equivalent 16-bit signed integer.

ToInt32(Decimal) ToInt32(Decimal) ToInt32(Decimal) ToInt32(Decimal)

Converte o valor do Decimal especificado para o inteiro com sinal de 32 bits equivalente.Converts the value of the specified Decimal to the equivalent 32-bit signed integer.

ToInt64(Decimal) ToInt64(Decimal) ToInt64(Decimal) ToInt64(Decimal)

Converte o valor do Decimal especificado no inteiro com sinal de 64 bits equivalente.Converts the value of the specified Decimal to the equivalent 64-bit signed integer.

ToOACurrency(Decimal) ToOACurrency(Decimal) ToOACurrency(Decimal) ToOACurrency(Decimal)

Converte o valor Decimal especificado no valor de moeda de Automação OLE equivalente, que é contido em um inteiro com sinal de 64 bits.Converts the specified Decimal value to the equivalent OLE Automation Currency value, which is contained in a 64-bit signed integer.

ToSByte(Decimal) ToSByte(Decimal) ToSByte(Decimal) ToSByte(Decimal)

Converte o valor do Decimal especificado no inteiro com sinal de 8 bits equivalente.Converts the value of the specified Decimal to the equivalent 8-bit signed integer.

ToSingle(Decimal) ToSingle(Decimal) ToSingle(Decimal) ToSingle(Decimal)

Converte o valor do Decimal especificado no número de ponto flutuante de precisão simples equivalente.Converts the value of the specified Decimal to the equivalent single-precision floating-point number.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente.Converts the numeric value of this instance to its equivalent string representation.

ToUInt16(Decimal) ToUInt16(Decimal) ToUInt16(Decimal) ToUInt16(Decimal)

Converte o valor do Decimal especificado no inteiro sem sinal de 16 bits equivalente.Converts the value of the specified Decimal to the equivalent 16-bit unsigned integer.

ToUInt32(Decimal) ToUInt32(Decimal) ToUInt32(Decimal) ToUInt32(Decimal)

Converte o valor do Decimal especificado no inteiro sem sinal de 32 bits equivalente.Converts the value of the specified Decimal to the equivalent 32-bit unsigned integer.

ToUInt64(Decimal) ToUInt64(Decimal) ToUInt64(Decimal) ToUInt64(Decimal)

Converte o valor do Decimal especificado no inteiro sem sinal de 64 bits equivalente.Converts the value of the specified Decimal to the equivalent 64-bit unsigned integer.

Truncate(Decimal) Truncate(Decimal) Truncate(Decimal) Truncate(Decimal)

Retorna os dígitos integrais do Decimal especificado; todos os dígitos fracionários são descartados.Returns the integral digits of the specified Decimal; any fractional digits are discarded.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
TryParse(String, NumberStyles, IFormatProvider, Decimal) TryParse(String, NumberStyles, IFormatProvider, Decimal) TryParse(String, NumberStyles, IFormatProvider, Decimal) TryParse(String, NumberStyles, IFormatProvider, Decimal)

Converte a representação de cadeia de caracteres de um número em seu Decimal equivalente usando o formato específico da cultura e estilo especificados.Converts the string representation of a number to its Decimal equivalent using the specified style and culture-specific format. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Decimal) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Decimal) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Decimal) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Decimal)
TryParse(ReadOnlySpan<Char>, Decimal) TryParse(ReadOnlySpan<Char>, Decimal) TryParse(ReadOnlySpan<Char>, Decimal) TryParse(ReadOnlySpan<Char>, Decimal)
TryParse(String, Decimal) TryParse(String, Decimal) TryParse(String, Decimal) TryParse(String, Decimal)

Converte a representação da cadeia de caracteres de um número no Decimal equivalente.Converts the string representation of a number to its Decimal equivalent. Um valor de retorno indica se a conversão foi bem-sucedida ou falhou.A return value indicates whether the conversion succeeded or failed.

Operadores

Addition(Decimal, Decimal) Addition(Decimal, Decimal) Addition(Decimal, Decimal) Addition(Decimal, Decimal)

Soma dois valores Decimal especificados.Adds two specified Decimal values.

Decrement(Decimal) Decrement(Decimal) Decrement(Decimal) Decrement(Decimal)

Diminui o operando Decimal em um.Decrements the Decimal operand by one.

Division(Decimal, Decimal) Division(Decimal, Decimal) Division(Decimal, Decimal) Division(Decimal, Decimal)

Divide dois valores Decimal especificados.Divides two specified Decimal values.

Equality(Decimal, Decimal) Equality(Decimal, Decimal) Equality(Decimal, Decimal) Equality(Decimal, Decimal)

Retorna um valor que indica se dois valores Decimal são iguais.Returns a value that indicates whether two Decimal values are equal.

Explicit(Single to Decimal) Explicit(Single to Decimal) Explicit(Single to Decimal) Explicit(Single to Decimal)

Define uma conversão explícita de um número de ponto flutuante de precisão simples para um Decimal.Defines an explicit conversion of a single-precision floating-point number to a Decimal.

Explicit(Double to Decimal) Explicit(Double to Decimal) Explicit(Double to Decimal) Explicit(Double to Decimal)

Define uma conversão explícita de um número de ponto flutuante de precisão dupla como um Decimal.Defines an explicit conversion of a double-precision floating-point number to a Decimal.

Explicit(Decimal to UInt32) Explicit(Decimal to UInt32) Explicit(Decimal to UInt32) Explicit(Decimal to UInt32)

Define uma conversão explícita de um Decimal em um inteiro sem sinal de 32 bits.Defines an explicit conversion of a Decimal to a 32-bit unsigned integer.

Esta API não compatível com CLS.This API is not CLS-compliant.

Explicit(Decimal to UInt16) Explicit(Decimal to UInt16) Explicit(Decimal to UInt16) Explicit(Decimal to UInt16)

Define uma conversão explícita de um Decimal em um inteiro sem sinal de 16 bits.Defines an explicit conversion of a Decimal to a 16-bit unsigned integer.

Esta API não compatível com CLS.This API is not CLS-compliant.

Explicit(Decimal to Single) Explicit(Decimal to Single) Explicit(Decimal to Single) Explicit(Decimal to Single)

Define uma conversão explícita de um Decimal em um número de ponto flutuante de precisão simples.Defines an explicit conversion of a Decimal to a single-precision floating-point number.

Explicit(Decimal to SByte) Explicit(Decimal to SByte) Explicit(Decimal to SByte) Explicit(Decimal to SByte)

Define uma conversão explícita de um Decimal para um inteiro com sinal de 8 bits.Defines an explicit conversion of a Decimal to an 8-bit signed integer.

Esta API não compatível com CLS.This API is not CLS-compliant.

Explicit(Decimal to UInt64) Explicit(Decimal to UInt64) Explicit(Decimal to UInt64) Explicit(Decimal to UInt64)

Define uma conversão explícita de um Decimal em um inteiro sem sinal de 64 bits.Defines an explicit conversion of a Decimal to a 64-bit unsigned integer.

Esta API não compatível com CLS.This API is not CLS-compliant.

Explicit(Decimal to Int32) Explicit(Decimal to Int32) Explicit(Decimal to Int32) Explicit(Decimal to Int32)

Define uma conversão explícita de um Decimal para um inteiro com sinal de 32 bits.Defines an explicit conversion of a Decimal to a 32-bit signed integer.

Explicit(Decimal to Int16) Explicit(Decimal to Int16) Explicit(Decimal to Int16) Explicit(Decimal to Int16)

Define uma conversão explícita de um Decimal em um inteiro com sinal de 16 bits.Defines an explicit conversion of a Decimal to a 16-bit signed integer.

Explicit(Decimal to Double) Explicit(Decimal to Double) Explicit(Decimal to Double) Explicit(Decimal to Double)

Define uma conversão explícita de um Decimal para um número de ponto flutuante de precisão dupla.Defines an explicit conversion of a Decimal to a double-precision floating-point number.

Explicit(Decimal to Char) Explicit(Decimal to Char) Explicit(Decimal to Char) Explicit(Decimal to Char)

Define uma conversão explícita de um Decimal para um caractere Unicode.Defines an explicit conversion of a Decimal to a Unicode character.

Explicit(Decimal to Byte) Explicit(Decimal to Byte) Explicit(Decimal to Byte) Explicit(Decimal to Byte)

Define uma conversão explícita de um Decimal para um inteiro sem sinal de 8 bits.Defines an explicit conversion of a Decimal to an 8-bit unsigned integer.

Explicit(Decimal to Int64) Explicit(Decimal to Int64) Explicit(Decimal to Int64) Explicit(Decimal to Int64)

Define uma conversão explícita de um Decimal em um inteiro com sinal de 64 bits.Defines an explicit conversion of a Decimal to a 64-bit signed integer.

GreaterThan(Decimal, Decimal) GreaterThan(Decimal, Decimal) GreaterThan(Decimal, Decimal) GreaterThan(Decimal, Decimal)

Retorna um valor que indica se um Decimal especificado é maior que outro Decimal especificado.Returns a value indicating whether a specified Decimal is greater than another specified Decimal.

GreaterThanOrEqual(Decimal, Decimal) GreaterThanOrEqual(Decimal, Decimal) GreaterThanOrEqual(Decimal, Decimal) GreaterThanOrEqual(Decimal, Decimal)

Retorna um valor que indica se um Decimal especificado é maior ou igual a outro Decimal especificado.Returns a value indicating whether a specified Decimal is greater than or equal to another specified Decimal.

Implicit(UInt32 to Decimal) Implicit(UInt32 to Decimal) Implicit(UInt32 to Decimal) Implicit(UInt32 to Decimal)

Define uma conversão implícita de um inteiro sem sinal de 32 bits em um Decimal.Defines an implicit conversion of a 32-bit unsigned integer to a Decimal.

Esta API não compatível com CLS.This API is not CLS-compliant.

Implicit(UInt16 to Decimal) Implicit(UInt16 to Decimal) Implicit(UInt16 to Decimal) Implicit(UInt16 to Decimal)

Define uma conversão implícita de um inteiro sem sinal de 16 bits em um Decimal.Defines an implicit conversion of a 16-bit unsigned integer to a Decimal.

Esta API não compatível com CLS.This API is not CLS-compliant.

Implicit(SByte to Decimal) Implicit(SByte to Decimal) Implicit(SByte to Decimal) Implicit(SByte to Decimal)

Define uma conversão implícita de um inteiro com sinal de 8 bits em um Decimal.Defines an implicit conversion of an 8-bit signed integer to a Decimal.

Esta API não compatível com CLS.This API is not CLS-compliant.

Implicit(Int64 to Decimal) Implicit(Int64 to Decimal) Implicit(Int64 to Decimal) Implicit(Int64 to Decimal)

Define uma conversão implícita de um inteiro com sinal de 64 bits em um Decimal.Defines an implicit conversion of a 64-bit signed integer to a Decimal.

Implicit(Byte to Decimal) Implicit(Byte to Decimal) Implicit(Byte to Decimal) Implicit(Byte to Decimal)

Define uma conversão implícita de um inteiro sem sinal de 8 bits em um Decimal.Defines an implicit conversion of an 8-bit unsigned integer to a Decimal.

Implicit(Int16 to Decimal) Implicit(Int16 to Decimal) Implicit(Int16 to Decimal) Implicit(Int16 to Decimal)

Define uma conversão implícita de um inteiro com sinal de 16 bits em um Decimal.Defines an implicit conversion of a 16-bit signed integer to a Decimal.

Implicit(Char to Decimal) Implicit(Char to Decimal) Implicit(Char to Decimal) Implicit(Char to Decimal)

Define uma conversão implícita de um caractere Unicode para um Decimal.Defines an implicit conversion of a Unicode character to a Decimal.

Implicit(UInt64 to Decimal) Implicit(UInt64 to Decimal) Implicit(UInt64 to Decimal) Implicit(UInt64 to Decimal)

Define uma conversão implícita de um inteiro sem sinal de 64 bits em um Decimal.Defines an implicit conversion of a 64-bit unsigned integer to a Decimal.

Esta API não compatível com CLS.This API is not CLS-compliant.

Implicit(Int32 to Decimal) Implicit(Int32 to Decimal) Implicit(Int32 to Decimal) Implicit(Int32 to Decimal)

Define uma conversão implícita de um inteiro com sinal de 32 bits em um Decimal.Defines an implicit conversion of a 32-bit signed integer to a Decimal.

Increment(Decimal) Increment(Decimal) Increment(Decimal) Increment(Decimal)

Incrementa o operando Decimal em 1.Increments the Decimal operand by 1.

Inequality(Decimal, Decimal) Inequality(Decimal, Decimal) Inequality(Decimal, Decimal) Inequality(Decimal, Decimal)

Retorna um valor que indica se dois objetos Decimal têm valores diferentes.Returns a value that indicates whether two Decimal objects have different values.

LessThan(Decimal, Decimal) LessThan(Decimal, Decimal) LessThan(Decimal, Decimal) LessThan(Decimal, Decimal)

Retorna um valor que indica se um Decimal especificado é menor que outro Decimal especificado.Returns a value indicating whether a specified Decimal is less than another specified Decimal.

LessThanOrEqual(Decimal, Decimal) LessThanOrEqual(Decimal, Decimal) LessThanOrEqual(Decimal, Decimal) LessThanOrEqual(Decimal, Decimal)

Retorna um valor que indica se um Decimal especificado é menor ou igual a outro Decimal especificado.Returns a value indicating whether a specified Decimal is less than or equal to another specified Decimal.

Modulus(Decimal, Decimal) Modulus(Decimal, Decimal) Modulus(Decimal, Decimal) Modulus(Decimal, Decimal)

Retorna o resto da divisão de dois valores Decimal especificados.Returns the remainder resulting from dividing two specified Decimal values.

Multiply(Decimal, Decimal) Multiply(Decimal, Decimal) Multiply(Decimal, Decimal) Multiply(Decimal, Decimal)

Multiplica dois valores Decimal especificados.Multiplies two specified Decimal values.

Subtraction(Decimal, Decimal) Subtraction(Decimal, Decimal) Subtraction(Decimal, Decimal) Subtraction(Decimal, Decimal)

Subtrai dois valores Decimal especificados.Subtracts two specified Decimal values.

UnaryNegation(Decimal) UnaryNegation(Decimal) UnaryNegation(Decimal) UnaryNegation(Decimal)

Nega o valor do operando Decimal especificado.Negates the value of the specified Decimal operand.

UnaryPlus(Decimal) UnaryPlus(Decimal) UnaryPlus(Decimal) UnaryPlus(Decimal)

Retorna o valor do operando Decimal (o sinal do operando é inalterado).Returns the value of the Decimal operand (the sign of the operand is unchanged).

Implantações explícitas de interface

IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object)
IConvertible.GetTypeCode() IConvertible.GetTypeCode() IConvertible.GetTypeCode() IConvertible.GetTypeCode()
IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider)

Para obter uma descrição desse membro, consulte ToBoolean(IFormatProvider).For a description of this member, see ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider)

Para obter uma descrição desse membro, consulte ToByte(IFormatProvider).For a description of this member, see ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider)

Esta conversão não é suportada.This conversion is not supported. A tentativa de usar esse método lança um InvalidCastException.Attempting to use this method throws an InvalidCastException.

IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider)

Esta conversão não é suportada.This conversion is not supported. A tentativa de usar esse método lança um InvalidCastException.Attempting to use this method throws an InvalidCastException.

IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider)

Para obter uma descrição desse membro, consulte ToDecimal(IFormatProvider).For a description of this member, see ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider)

Para obter uma descrição desse membro, consulte ToDouble(IFormatProvider).For a description of this member, see ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider)

Para obter uma descrição desse membro, consulte ToInt16(IFormatProvider).For a description of this member, see ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider)

Para obter uma descrição desse membro, consulte ToInt32(IFormatProvider).For a description of this member, see ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider)

Para obter uma descrição desse membro, consulte ToInt64(IFormatProvider).For a description of this member, see ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider)

Para obter uma descrição desse membro, consulte ToSByte(IFormatProvider).For a description of this member, see ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider)

Para obter uma descrição desse membro, consulte ToSingle(IFormatProvider).For a description of this member, see ToSingle(IFormatProvider).

IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider)

Para obter uma descrição desse membro, consulte ToType(Type, IFormatProvider).For a description of this member, see ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider)

Para obter uma descrição desse membro, consulte ToUInt16(IFormatProvider).For a description of this member, see ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider)

Para obter uma descrição desse membro, consulte ToInt32(IFormatProvider).For a description of this member, see ToInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider)

Para obter uma descrição desse membro, consulte ToInt64(IFormatProvider).For a description of this member, see ToInt64(IFormatProvider).

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

Executado quando a desserialização de um objeto foi concluída.Runs when the deserialization of an object has been completed.

Aplica-se a

Acesso thread-safe

Todos os membros desse tipo são thread-safe.All members of this type are thread safe. Os membros que aparentam modificar efetivamente o estado retornam uma nova instância inicializada com o novo valor.Members that appear to modify instance state actually return a new instance initialized with the new value. Assim como acontece com qualquer outro tipo, a leitura e a gravação em uma variável compartilhada que contém uma instância desse tipo devem ser protegidas por um bloqueio para garantir thread-safe.As with any other type, reading and writing to a shared variable that contains an instance of this type must be protected by a lock to guarantee thread safety.

Veja também