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

Definition

Gibt einen als Zahl formatierten Ausdruck zurück.Returns an expression formatted as a number.

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.Required. Der zu formatierende Ausdruck.Expression to be formatted.

NumDigitsAfterDecimal
Int32

Dies ist optional.Optional. Numerischer Wert, der angibt, wie viele Stellen hinter dem Dezimaltrennzeichen angezeigt werden.Numeric value indicating how many places are displayed to the right of the decimal. Der Standardwert ist –1 und gibt an, dass die regionalen Einstellungen des Computers verwendet werden.The default value is -1, which indicates that the computer's regional settings are used.

IncludeLeadingDigit
TriState

Dies ist optional.Optional. TriState-Konstante, die angibt, ob bei Bruchwerten eine führende 0 angezeigt wird.TriState constant that indicates whether a leading 0 is displayed 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.TriState constant that indicates whether 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 Zahl formatierter Ausdruck.An expression formatted as a number.

Ausnahmen

Typ ist nicht numerisch.Type is not numeric.

Beispiele

In diesem Beispiel wird die- FormatNumber Funktion veranschaulicht.This example demonstrates the FormatNumber function.

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

Hinweise

Wenn mindestens ein optionales Argument weggelassen wird, 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.UseDefault Die regionalen Einstellungen des ComputersThe computer's regional settings

Gilt für:

Siehe auch