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

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Strings.vb

Quelle:: Strings.vb

Quelle:: Strings.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt einen Ausdruck als Prozentangabe (d. h. multipliziert mit 100) und einem abschließenden %-Zeichen zurück.

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. Der zu formatierende Ausdruck.

NumDigitsAfterDecimal: Int32

Dies ist optional. Numerischer Wert, der angibt, wie viele Stellen rechts neben dem Dezimaltrennzeichen angezeigt werden. Der Standardwert ist –1, was darauf hinweist, dass die Einstellungen des Gebietsschemas verwendet werden.

IncludeLeadingDigit: TriState

Dies ist optional. TriState-Konstante, die angibt, ob bei Dezimalzahlen eine führende Null angezeigt werden soll. Die Werte finden Sie unter „Einstellungen“.

UseParensForNegativeNumbers: TriState

Dies ist optional. TriState-Konstante, die angibt, ob negative Werte in Klammern gesetzt werden sollen. Die Werte finden Sie unter „Einstellungen“.

GroupDigits: TriState

Dies ist optional. TriState-Konstante, die angibt, ob Ziffern mithilfe des in den Gebietsschemaeinstellungen angegebenen Gruppentrennzeichens gruppiert werden sollen. Die Werte finden Sie unter „Einstellungen“.

Gibt zurück

String

Ein als Prozentangabe (d. h. multipliziert mit 100) und mit einem abschließenden %-Zeichen formatierter Ausdruck.

Ausnahmen

InvalidCastException

Typ ist nicht numerisch.

Beispiele

In diesem Beispiel wird die Verwendung der FormatPercent -Funktion veranschaulicht.

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

Hinweise

Wenn ein oder mehrere optionale Argumente weggelassen werden, werden die Werte für ausgelassene Argumente von den Gebietsschemaeinstellungen bereitgestellt.

Hinweis

Alle Einstellungsinformationen stammen aus dem Gebietsschema der Anwendung. Standardmäßig ist dies das in der Systemsteuerung festgelegte Gebietsschema. Es kann jedoch programmgesteuert mithilfe der .NET Framework geändert werden.

Die IncludeLeadingDigitArgumente , UseParensForNegativeNumbersund GroupDigits verfügen über die folgenden Einstellungen.

Konstante	BESCHREIBUNG
`TriState.True`	True
`TriState.False`	False
`TriState.Default`	Die regionalen Einstellungen des Computers

Gilt für: