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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retorna uma expressão formatada como uma porcentagem (ou seja, 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);
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

Required. Expressão a ser formatada.

NumDigitsAfterDecimal
Int32

Optional. Valor numérico que indica quantas casas à direita do decimal são apresentadas. O valor padrão é -1, que indica que as configurações de localidade são usadas.

IncludeLeadingDigit
TriState

Optional. TriState constante que indica se um zero à esquerda é exibido ou não para valores fracionários. Consulte "Configurações" para obter valores.

UseParensForNegativeNumbers
TriState

Optional. TriState constante que indica se os valores negativos devem ou não ser colocados entre parênteses. Consulte "Configurações" para obter valores.

GroupDigits
TriState

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

Retornos

String

Uma expressão formatada como uma porcentagem (ou seja, multiplicada por 100) com um caractere % à direita.

Exceções

InvalidCastException

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 dos 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.

O IncludeLeadingDigit, UseParensForNegativeNumberse GroupDigits os argumentos têm as seguintes configurações.

Constante Description
TriState.True Verdade
TriState.False Falso
TriState.Default As configurações regionais do computador

Aplica-se a

Confira também