Função FormatNumber (Visual Basic)
Retorna uma expressão formatada como um número.
Function FormatNumber(
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 são exibidas à direita da vírgula decimal.O valor padrão é – 1, que indica que as configurações regionais do computador são usadas.IncludeLeadingDigit
Opcional.Constante TriState indica se um zero principal é exibida para valores fracionários.Consulte "Configurações" para os valores.UseParensForNegativeNumbers
Opcional.Constante TriState indica se é necessário colocar valores negativos entre parênteses.Consulte "Configurações" para os valores.GroupDigits
Opcional.Constante TriState que indica se ou não os números são agrupados usando o delimitador de grupo 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.UseDefault |
As configurações regionais do computador |
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
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 para argumentos omitidos são fornecidos pelas configurações de localidade.
.gif "Observação") 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 demonstra a função FormatNumber.
Dim TestNumber As Integer = 45600
' Returns "45,600.00".
Dim TestString As String = FormatNumber(TestNumber, 2, , , TriState.True)
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)