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

Definition

Gibt einen Ausdruck als Prozentangabe (d. h. multipliziert mit 100) und einem abschließenden %-Zeichen zurück.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);
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

Parameter

Expression
Object

Erforderlich.Required. Der zu formatierende Ausdruck.Expression to be formatted.

NumDigitsAfterDecimal
Int32

Dies ist optional.Optional. Numerischer Wert, der angibt, wie viele Stellen rechts neben dem Dezimaltrennzeichen angezeigt werden.Numeric value indicating how many places to the right of the decimal are displayed. Der Standardwert ist –1, was darauf hinweist, dass die Einstellungen des Gebietsschemas verwendet werden.Default value is -1, which indicates that the locale settings are used.

IncludeLeadingDigit
TriState

Dies ist optional.Optional. TriState-Konstante, die angibt, ob bei Dezimalzahlen eine führende Null angezeigt werden soll.TriState constant that indicates whether or not a leading zero displays for fractional values. Die Werte finden Sie unter „Einstellungen“.See "Settings" for values.

UseParensForNegativeNumbers
TriState

Dies ist optional.Optional. TriState-Konstante, die angibt, ob negative Werte in Klammern gesetzt werden sollen.TriState constant that indicates whether or not to place negative values within parentheses. Die Werte finden Sie unter „Einstellungen“.See "Settings" for values.

GroupDigits
TriState

Dies ist optional.Optional. TriState-Konstante, die angibt, ob Ziffern mithilfe des in den Gebietsschemaeinstellungen angegebenen Gruppentrennzeichens gruppiert werden sollen.TriState constant that indicates whether or not numbers are grouped using the group delimiter specified in the locale settings. Die Werte finden Sie unter „Einstellungen“.See "Settings" for values.

Gibt zurück

String

Ein als Prozentangabe (d. h. multipliziert mit 100) und mit einem abschließenden %-Zeichen formatierter Ausdruck.An expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.

Ausnahmen

Typ ist nicht numerisch.Type is not numeric.

Beispiele

In diesem Beispiel wird die Verwendung der- FormatPercent Funktion veranschaulicht.This example illustrates the use of the FormatPercent function.

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

Hinweise

Wenn ein oder mehrere optionale Argumente ausgelassen werden, werden die Werte für ausgelassene Argumente von den Gebiets Schema Einstellungen bereitgestellt.When one or more optional arguments are omitted, the values for omitted arguments are provided by the locale settings.

Hinweis

Alle Einstellungs Informationen stammen aus dem Gebiets Schema der Anwendung.All settings information comes from the locale of the application. Standardmäßig handelt es sich dabei um das in der Systemsteuerung festgelegte Gebiets Schema.By default, that will be the locale set in the control panel. Sie kann jedoch mithilfe der .NET Framework Programm gesteuert geändert werden.However, it may be changed programmatically by using the .NET Framework.

Die IncludeLeadingDigit UseParensForNegativeNumbers Argumente, und GroupDigits haben die folgenden Einstellungen.The IncludeLeadingDigit, UseParensForNegativeNumbers, and GroupDigits arguments have the following settings.

KonstanteConstant BESCHREIBUNGDescription
TriState.True TrueTrue
TriState.False FalseFalse
TriState.Default Die regionalen Einstellungen des ComputersThe computer's regional settings

Gilt für:

Siehe auch