Strings.FormatNumber(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 als Zahl formatierten Ausdruck zurück.

public static string FormatNumber (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 FormatNumber (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 FormatNumber : obj * int * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState * Microsoft.VisualBasic.TriState -> string

Public Function FormatNumber (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 hinter dem Dezimaltrennzeichen angezeigt werden. Der Standardwert ist –1 und gibt an, dass die regionalen Einstellungen des Computers verwendet werden.

IncludeLeadingDigit: TriState

Dies ist optional. TriState-Konstante, die angibt, ob bei Bruchwerten eine führende 0 angezeigt wird. Die Werte finden Sie unter „Einstellungen“.

UseParensForNegativeNumbers: TriState

Dies ist optional. TriState-Konstante, die angibt, ob negative Werte in Klammern gesetzt werden. 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 Zahl formatierter Ausdruck.

Ausnahmen

InvalidCastException

Typ ist nicht numerisch.

Beispiele

In diesem Beispiel wird die FormatNumber -Funktion veranschaulicht.

Dim testNumber As Integer = 45600
' Returns "45,600.00".
Dim testString As String = FormatNumber(testNumber, 2, , , TriState.True)

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.UseDefault`	Die regionalen Einstellungen des Computers

Gilt für: