Partager via

Strings.FormatPercent, méthode

  • Article

Retourne une expression sous la forme d'un pourcentage (c'est-à-dire multiplié par 100) avec le caractère de fin %.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function FormatPercent ( _
    Expression As Object, _
    <OptionalAttribute> Optional NumDigitsAfterDecimal As Integer = -1, _
    <OptionalAttribute> Optional IncludeLeadingDigit As TriState = TriState.UseDefault, _
    <OptionalAttribute> Optional UseParensForNegativeNumbers As TriState = TriState.UseDefault, _
    <OptionalAttribute> Optional GroupDigits As TriState = TriState.UseDefault _
) As String
'Utilisation
Dim Expression As Object
Dim NumDigitsAfterDecimal As Integer
Dim IncludeLeadingDigit As TriState
Dim UseParensForNegativeNumbers As TriState
Dim GroupDigits As TriState
Dim returnValue As String

returnValue = Strings.FormatPercent(Expression, NumDigitsAfterDecimal, IncludeLeadingDigit, UseParensForNegativeNumbers, GroupDigits)

public static string FormatPercent (
    Object Expression,
    [OptionalAttribute] int NumDigitsAfterDecimal,
    [OptionalAttribute] TriState IncludeLeadingDigit,
    [OptionalAttribute] TriState UseParensForNegativeNumbers,
    [OptionalAttribute] TriState GroupDigits
)

public:
static String^ FormatPercent (
    Object^ Expression, 
    [OptionalAttribute] int NumDigitsAfterDecimal, 
    [OptionalAttribute] TriState IncludeLeadingDigit, 
    [OptionalAttribute] TriState UseParensForNegativeNumbers, 
    [OptionalAttribute] TriState GroupDigits
)

public static String FormatPercent (
    Object Expression, 
    /** @attribute OptionalAttribute() */ int NumDigitsAfterDecimal, 
    /** @attribute OptionalAttribute() */ TriState IncludeLeadingDigit, 
    /** @attribute OptionalAttribute() */ TriState UseParensForNegativeNumbers, 
    /** @attribute OptionalAttribute() */ TriState GroupDigits
)

public static function FormatPercent (
    Expression : Object, 
    NumDigitsAfterDecimal : int, 
    IncludeLeadingDigit : TriState, 
    UseParensForNegativeNumbers : TriState, 
    GroupDigits : TriState
) : String

Paramètres

  • Expression
    Obligatoire. Expression à mettre en forme.
  • NumDigitsAfterDecimal
    Facultatif. Valeur numérique indiquant le nombre de décimales affichées. La valeur par défaut est –1, ce qui indique que les paramètres régionaux sont utilisés.
  • IncludeLeadingDigit
    Consultez la section « Paramètres » pour obtenir les valeurs.
  • UseParensForNegativeNumbers
    Consultez la section « Paramètres » pour obtenir les valeurs.
  • GroupDigits
    Facultatif. Constante TriState qui indique si les nombres doivent ou non être regroupés en utilisant le délimiteur de groupe spécifié dans les paramètres régionaux. Consultez la section « Paramètres » pour obtenir les valeurs.

Valeur de retour

Retourne une expression sous la forme d'un pourcentage (c'est-à-dire multiplié par 100) avec le caractère de fin %.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic FormatPercent, fonction (Visual Basic).

Lorsqu'un ou plusieurs arguments facultatifs sont omis, les valeurs des arguments omis sont fournies par les paramètres régionaux.

Notes

Tous les paramètres sont issus des paramètres régionaux de l'application. Par défaut, il s'agit des paramètres régionaux définis dans le Panneau de configuration. Toutefois, ils peuvent être modifiés par programme en utilisant le .NET Framework.

Les paramètres des arguments IncludeLeadingDigit, UseParensForNegativeNumbers et GroupDigits sont les suivants :

Constante

Description

TriState.True

True

TriState.False

False

TriState.Default

Paramètres régionaux de l'ordinateur

Exemple

Cet exemple montre l'utilisation de la fonction FormatPercent.

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

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
InvalidCastException

Autres ressources

FormatPercent, fonction (Visual Basic)
Liste des manipulations de chaînes
FormatCurrency, fonction (Visual Basic)
FormatDateTime, fonction (Visual Basic)
FormatNumber, fonction (Visual Basic)
Tristate, énumération