Função FormatPercent (Visual Basic)

Artigo
08/25/2010

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

Partilhar via