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

Definición

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

Devuelve una expresión con formato de porcentaje (es decir, multiplicada por 100) con un carácter % final.Returns an expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

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);
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.Required. Expresión a la que se debe dar formato.Expression to be formatted.

NumDigitsAfterDecimal
Int32

Opcional.Optional. Valor numérico que indica cuántos lugares a la derecha del decimal se muestran.Numeric value indicating how many places to the right of the decimal are displayed. El valor predeterminado es -1, que indica que se utiliza la configuración regional.Default value is -1, which indicates that the locale settings are used.

IncludeLeadingDigit
TriState

Opcional.Optional. Constante TriState que indica si se debe o no mostrar un cero inicial en los valores fraccionarios.TriState constant that indicates whether or not a leading zero displays for fractional values. Consulte los valores en "Configuración".See "Settings" for values.

UseParensForNegativeNumbers
TriState

Opcional.Optional. TriState constante que indica si hay que poner los valores negativos entre paréntesis.TriState constant that indicates whether or not to place negative values within parentheses. Consulte los valores en "Configuración".See "Settings" for values.

GroupDigits
TriState

Opcional.Optional. Constante TriState que indica si los números se agrupan o no mediante el delimitador de grupo especificado en la configuración regional.TriState constant that indicates whether or not numbers are grouped using the group delimiter specified in the locale settings. Consulte los valores en "Configuración".See "Settings" for values.

Devoluciones

String

Expresión con formato de porcentaje (es decir, multiplicada por 100) con un carácter % final.An expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

Excepciones

InvalidCastException

El tipo no es numérico.Type is not numeric.

Ejemplos

En este ejemplo se muestra el uso de la FormatPercent función.This example illustrates the use of the FormatPercent function.

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

Comentarios

Cuando se omiten uno o más argumentos opcionales, la configuración regional proporciona los valores de los argumentos omitidos.When one or more optional arguments are omitted, the values for omitted arguments are provided by the locale settings.

Nota

Toda la información de configuración procede de la configuración regional de la aplicación.All settings information comes from the locale of the application. De forma predeterminada, será la configuración regional establecida en el panel de control.By default, that will be the locale set in the control panel. Sin embargo, se puede cambiar mediante programación con el .NET Framework.However, it may be changed programmatically by using the .NET Framework.

Los IncludeLeadingDigit UseParensForNegativeNumbers argumentos, y GroupDigits tienen la siguiente configuración.The IncludeLeadingDigit, UseParensForNegativeNumbers, and GroupDigits arguments have the following settings.

ConstanteConstant DescripciónDescription
TriState.True TrueTrue
TriState.False FalseFalse
TriState.Default La configuración regional del equipoThe computer's regional settings

Se aplica a

Consulte también