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

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.dll

Devuelve una expresión con formato de valor de moneda usando el símbolo de moneda definido en el panel de control del 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);
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

Required. Expresión a la que se va a dar formato.

NumDigitsAfterDecimal
Int32

Optional. Valor numérico que indica cuántos lugares se muestran a la derecha del decimal. El valor predeterminado es -1, lo que indica que se usa la configuración regional del equipo.

IncludeLeadingDigit
TriState

Optional. TriState enumeración que indica si se muestra o no un cero inicial para los valores fraccionarios. Vea "Comentarios" para ver los valores.

UseParensForNegativeNumbers
TriState

Optional. TriState enumeración que indica si se deben colocar valores negativos entre paréntesis. Vea "Comentarios" para ver los valores.

GroupDigits
TriState

Optional. TriState enumeración que indica si los números se agrupan mediante el delimitador de grupo especificado en la configuración regional del equipo. Vea "Comentarios" para ver los valores.

Devoluciones

String

Expresión con formato de valor de moneda mediante el símbolo de moneda definido en el panel de control del sistema.

Excepciones

ArgumentException

El número de dígitos después del separador decimal es mayor que 99.

InvalidCastException

El tipo no es numérico.

Ejemplos

En el ejemplo siguiente se muestra el uso de la FormatCurrency función .

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

Comentarios

Cuando se omiten uno o varios argumentos opcionales, se usan en su lugar los valores de configuración regional coincidentes del equipo.

La posición del símbolo de moneda en relación con el valor de la moneda viene determinada por la configuración regional del sistema.

Nota:

Toda la información de configuración procede de la configuración regional de la aplicación. De forma predeterminada, será la configuración regional establecida en el panel de control. Sin embargo, se puede cambiar mediante programación mediante el uso de .NET Framework, excepto el cero inicial, que procede de la pestaña Number.

Los IncludeLeadingDigitargumentos , UseParensForNegativeNumbersy GroupDigits toman los siguientes valores de enumeración TriState.

Value Description
TriState.True Cierto
TriState.False Falso
TriState.UseDefault Configuración regional del equipo

Se aplica a

Consulte también