Strings.FormatCurrency(Object, Int32, TriState, TriState, TriState) Método

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Strings.vb

Origem:: Strings.vb

Origem:: Strings.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma expressão formatada como um valor de moeda usando o símbolo da moeda definido no painel de controle do sistema.

public static string FormatCurrency (object? Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);

public static string FormatCurrency (object Expression, int NumDigitsAfterDecimal = -1, Microsoft.VisualBasic.TriState IncludeLeadingDigit = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState UseParensForNegativeNumbers = Microsoft.VisualBasic.TriState.UseDefault, Microsoft.VisualBasic.TriState GroupDigits = Microsoft.VisualBasic.TriState.UseDefault);

static member FormatCurrency : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string

Public Function FormatCurrency (Expression As Object, Optional NumDigitsAfterDecimal As Integer = -1, Optional IncludeLeadingDigit As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional UseParensForNegativeNumbers As TriState = Microsoft.VisualBasic.TriState.UseDefault, Optional GroupDigits As TriState = Microsoft.VisualBasic.TriState.UseDefault) As String

Parâmetros

Expression: Object

Obrigatórios. Expressão a ser formatada.

NumDigitsAfterDecimal: Int32

Opcional. Valor numérico indicando quantas casas são exibidas à direita do decimal. O valor padrão é -1, que indica que as configurações regionais do computador são usadas.

IncludeLeadingDigit: TriState

Opcional. A enumeração TriState que indica se um zero à esquerda é exibido ou não para valores fracionários. Consulte "Comentários" para obter os valores.

UseParensForNegativeNumbers: TriState

Opcional. A enumeração TriState que indica se é necessário ou não colocar valores negativos entre parênteses. Consulte "Comentários" para obter os valores.

GroupDigits: TriState

Opcional. A enumeração TriState que indica se os números são agrupados ou não usando o delimitador de grupo especificado nas configurações regionais do computador. Consulte "Comentários" para obter os valores.

Retornos

String

Uma expressão formatada como um valor de moeda usando o símbolo da moeda definido no painel de controle do sistema.

Exceções

ArgumentException

O número de dígitos após o ponto decimal é maior que 99.

InvalidCastException

O tipo não é numérico.

Exemplos

O exemplo a seguir ilustra o uso da função FormatCurrency.

Dim testDebt As Double = -4456.43
Dim testString As String
' Returns "($4,456.43)".
testString = FormatCurrency(testDebt, , , TriState.True, TriState.True)

Comentários

Quando um ou mais argumentos opcionais são omitidos, os valores de configurações regionais correspondentes do computador são usados.

A posição do símbolo de moeda em relação ao valor de moeda é determinada pelas configurações regionais do sistema.

Observação

Todas as informações de configurações vêm da localidade do aplicativo. Por padrão, essa será a localidade definida no painel de controle. No entanto, ele pode ser alterado programaticamente usando o .NET Framework, exceto o zero à esquerda, que vem da Number guia .

Os IncludeLeadingDigitargumentos , UseParensForNegativeNumberse GroupDigits assumem os seguintes valores de enumeração TriState.

Valor	Descrição
`TriState.True`	True
`TriState.False`	Falso
`TriState.UseDefault`	As configurações regionais do computador

Aplica-se a

Produto	Versões
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.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

Compartilhar via