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

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une expression au format pourcentage (c’est-à-dire multipliée par 100) avec le caractère de fin %.

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

Paramètres

Expression: Object

Obligatoire. Expression à mettre en forme.

NumDigitsAfterDecimal: Int32

Optionnel. Valeur numérique indiquant le nombre de positions affichées à droite du séparateur décimal. La valeur par défaut est -1, ce qui indique que les paramètres régionaux sont utilisés.

IncludeLeadingDigit: TriState

Optionnel. Constante TriState qui indique si un zéro non significatif s’affiche pour les valeurs décimales. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

UseParensForNegativeNumbers: TriState

Optionnel. Constante TriState qui indique si les valeurs négatives doivent être mises entre parenthèses. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

GroupDigits: TriState

Optionnel. Constante TriState qui indique si les nombres sont regroupés ou non selon le délimiteur de groupe spécifié dans les paramètres régionaux. Pour connaître les valeurs, consultez la rubrique « Paramètres ».

Retours

String

Une expression au format pourcentage (c’est-à-dire multipliée par 100) avec le caractère de fin %.

Exceptions

InvalidCastException

Le type n’est pas numérique.

Exemples

Cet exemple illustre l’utilisation de la FormatPercent fonction .

Dim testNumber As Single = 0.76
' Returns "76.00%".
Dim testString As String = FormatPercent(testNumber)

Remarques

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

Remarque

Toutes les informations de paramètres proviennent des paramètres régionaux de l’application. Par défaut, il s’agira des paramètres régionaux définis dans le panneau de configuration. Toutefois, il peut être modifié par programmation à l’aide du .NET Framework.

Les IncludeLeadingDigitarguments , UseParensForNegativeNumberset GroupDigits ont les paramètres suivants.

Constant	Description
`TriState.True`	True
`TriState.False`	False
`TriState.Default`	Paramètres régionaux de l’ordinateur

S’applique à

Produit	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Partage via