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

Definição

Retorna uma expressão formatada como um percentual (isto é, multiplicada por 100) com um caractere % à direita.

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

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 de localidade são usadas.

IncludeLeadingDigit
TriState

Opcional. A constante TriState que indica se um zero à esquerda é exibido ou não para valores fracionários. Consulte “Configurações” para obter os valores.

UseParensForNegativeNumbers
TriState

Opcional. A constante TriState que indica se é necessário ou não colocar valores negativos entre parênteses. Consulte “Configurações” para obter os valores.

GroupDigits
TriState

Opcional. A constante TriState que indica se os números são agrupados usando o delimitador de grupo especificado nas configurações de localidade ou não. Consulte “Configurações” para obter os valores.

Retornos

Uma expressão formatada como um percentual (isto é, multiplicada por 100) com um caractere % à direita.

Exceções

O tipo não é numérico.

Exemplos

Este exemplo ilustra o uso da FormatPercent função .

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

Comentários

Quando um ou mais argumentos opcionais são omitidos, os valores para argumentos omitidos são fornecidos pelas configurações de localidade.

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.

Os IncludeLeadingDigitargumentos , UseParensForNegativeNumberse GroupDigits têm as seguintes configurações.

Constante Descrição
TriState.True True
TriState.False Falso
TriState.Default As configurações regionais do computador

Aplica-se a

Confira também