Strings.FormatNumber(Object, Int32, TriState, TriState, TriState) メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

Strings.vb

数値形式の文字列に書式設定して返す文字列処理関数です。

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

パラメーター

Expression

Object

必須です。 書式指定される式。

NumDigitsAfterDecimal

Int32

省略可能。 表示される小数点以下の桁数を示す数値。 既定値は -1 です。これは、コンピューターの地域設定が使用されることを示しています。

IncludeLeadingDigit

TriState

省略可能。 小数値の先頭の 0 を表示するかどうかを示す TriState 定数。 値については、「設定」を参照してください。

UseParensForNegativeNumbers

TriState

省略可能。 負の値をかっこで囲むかどうかを示す TriState 定数。 値については、「設定」を参照してください。

GroupDigits

TriState

省略可能。 ロケール設定で指定されている桁区切り記号を使用して、数値を区切るかどうかを表す TriState 定数を指定します。 値については、「設定」を参照してください。

戻り値

String

数値に形式が変換された式です。

例外

InvalidCastException

型が数字ではありません。

例

この例では、 関数を FormatNumber 示します。

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

注釈

1 つ以上の省略可能な引数を省略すると、省略された引数の値がロケール設定によって提供されます。

注意

すべての設定情報は、アプリケーションのロケールから取得されます。 既定では、コントロール パネルで設定されたロケールになります。 ただし、.NET Frameworkを使用してプログラムで変更できます。

、IncludeLeadingDigitUseParensForNegativeNumbers、および GroupDigits の各引数には、次の設定があります。

定数	説明
TriState.True	True
TriState.False	False
TriState.UseDefault	コンピューターの地域設定

こちらもご覧ください

• FormatCurrency(Object, Int32, TriState, TriState, TriState)
• FormatDateTime(DateTime, DateFormat)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• TriState
• InvalidCastException
• 文字列操作の概要