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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: Strings.vb

Origem:: Strings.vb

Origem:: Strings.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

String

Uma expressão formatada como um percentual (isto é, 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 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

Compartilhar via