Strings.FormatPercent(Object, Int32, TriState, TriState, TriState) Method

Definition

Restituisce un'espressione formattata come percentuale (ovvero moltiplicata per 100) con un carattere % finale.Returns an expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

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

Parameters

Expression
Object

Obbligatorio.Required. Espressione da formattare.Expression to be formatted.

NumDigitsAfterDecimal
Int32

facoltativo.Optional. Valore numerico che indica il numero di cifre da visualizzare a destra del separatore decimale.Numeric value indicating how many places to the right of the decimal are displayed. Il valore predefinito -1 indica che vengono usate le impostazioni locali.Default value is -1, which indicates that the locale settings are used.

IncludeLeadingDigit
TriState

facoltativo.Optional. Costante TriState che consente di specificare se visualizzare o meno uno zero davanti ai valori frazionari.TriState constant that indicates whether or not a leading zero displays for fractional values. Per un elenco dei valori possibili, vedere "Impostazioni".See "Settings" for values.

UseParensForNegativeNumbers
TriState

facoltativo.Optional. Costante TriState che consente di specificare se racchiudere o meno i valori negativi tra parentesi.TriState constant that indicates whether or not to place negative values within parentheses. Per un elenco dei valori possibili, vedere "Impostazioni".See "Settings" for values.

GroupDigits
TriState

facoltativo.Optional. Costante TriState che consente di specificare se raggruppare o meno i numeri usando il carattere di delimitazione di gruppo specificato nelle impostazioni locali.TriState constant that indicates whether or not numbers are grouped using the group delimiter specified in the locale settings. Per un elenco dei valori possibili, vedere "Impostazioni".See "Settings" for values.

Returns

String

Espressione formattata come percentuale (ovvero moltiplicata per 100) con un carattere % finale.An expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

Exceptions

Tipo non numerico.Type is not numeric.

Examples

Questo esempio illustra l'uso della funzione FormatPercent.This example illustrates the use of the FormatPercent function.

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

Remarks

Quando uno o più argomenti facoltativi vengono omessi, i valori degli argomenti omessi vengono forniti dalle impostazioni locali.When one or more optional arguments are omitted, the values for omitted arguments are provided by the locale settings.

Note

Tutte le informazioni sulle impostazioni provengono dalle impostazioni locali dell'applicazione.All settings information comes from the locale of the application. Per impostazione predefinita, verranno impostate le impostazioni locali nel pannello di controllo.By default, that will be the locale set in the control panel. Tuttavia, può essere modificato a livello di programmazione tramite il .NET Framework.However, it may be changed programmatically by using the .NET Framework.

Gli argomenti IncludeLeadingDigit, UseParensForNegativeNumberse GroupDigits hanno le impostazioni seguenti.The IncludeLeadingDigit, UseParensForNegativeNumbers, and GroupDigits arguments have the following settings.

CostanteConstant DescrizioneDescription
TriState.True TrueTrue
TriState.False FalseFalse
TriState.Default Impostazioni internazionali del computerThe computer's regional settings

Applies to

See also