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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Devuelve una expresión con formato de porcentaje (es decir, multiplicada por 100) con un carácter % final.

public static string FormatPercent (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 FormatPercent : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string

Public Function FormatPercent (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

Obligatorio. Expresión a la que se debe dar formato.

NumDigitsAfterDecimal

Int32

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

IncludeLeadingDigit

TriState

Opcional. Constante TriState que indica si se debe o no mostrar un cero inicial en los valores fraccionarios. Consulte los valores en "Configuración".

UseParensForNegativeNumbers

TriState

Opcional. TriState constante que indica si hay que poner los valores negativos entre paréntesis. Consulte los valores en "Configuración".

GroupDigits

TriState

Opcional. Constante TriState que indica si los números se agrupan o no mediante el delimitador de grupo especificado en la configuración regional. Consulte los valores en "Configuración".

Devoluciones

String

Expresión con formato de porcentaje (es decir, multiplicada por 100) con un carácter % final.

Excepciones

InvalidCastException

El tipo no es numérico.

Ejemplos

En este ejemplo se muestra el uso de la FormatPercent función .

Dim testNumber As Single = 0.76
' Returns "76.00%".
Dim testString As String = FormatPercent(testNumber)

Comentarios

Cuando se omiten uno o varios argumentos opcionales, la configuración regional proporciona los valores de los argumentos omitidos.

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 .NET Framework.

Los IncludeLeadingDigitargumentos , UseParensForNegativeNumbersy GroupDigits tienen la siguiente configuración.

Constante	Descripción
TriState.True	True
TriState.False	False
TriState.Default	Configuración regional del equipo

Consulte también

• FormatCurrency(Object, Int32, TriState, TriState, TriState)
• FormatDateTime(DateTime, DateFormat)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• Format(Object, String)
• TriState
• InvalidCastException
• Resumen de la manipulación de cadenas