Compartilhar via


Função FormatPercent (Visual Basic)

Retorna uma expressão formatada sistema autônomo uma porcentagem (isto é, multiplicada por 100) com um caractere % à direita.

Function FormatPercent(
   ByVal Expression As Object,
   Optional ByVal NumDigitsAfterDecimal As Integer = -1,
   Optional ByVal IncludeLeadingDigit As TriState = TriState.UseDefault,
   Optional ByVal UseParensForNegativeNumbers As TriState = TriState.UseDefault,
   Optional ByVal GroupDigits As TriState = TriState.UseDefault
) As String

Parâmetros

  • Expression
    Obrigatório.Expressão a ser formatada.

  • NumDigitsAfterDecimal
    Opcional.Valor numérico indicando quantas casas à direita do decimal são exibidos.Valor padrão é – 1, o que indica que as configurações de localidade são utilizadas.

  • IncludeLeadingDigit
    Opcional.TriState constante que indica se ou não exibe um zero entrelinhamento para valores fracionários. Consulte "Configurações" para os valores.

  • UseParensForNegativeNumbers
    Opcional.TriState constante que indica se deve ou não coloque os valores negativos entre parênteses. Consulte "Configurações" para os valores.

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

Configurações

Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers, e GroupDigits têm as seguintes configurações.

Constante

Descrição

TriState.True

True

TriState.False

False

TriState.Default

As configurações regionais do computador

Exceções

Tipo de exceção

Número de erro

Condição

InvalidCastException

13

Tipo é não numérico.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

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

Observação:

Todas as informações de configuração vêm da localidade do aplicativo.Por padrão, este será o conjunto de localidade no Painel de controle.No entanto, ele pode ser alterado por meio de programação usando o .NET Framework.

Exemplo

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

Dim TestNumber As Single = 0.76
' Returns "76.00%".
Dim TestString As String = FormatPercent(TestNumber)

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Sumário de Manipulação de Strings

Função FormatCurrency (Visual Basic)

Função FormatDateTime (Visual Basic)

Função FormatNumber (Visual Basic)

Enumeração TriState

InvalidCastException