Int16.ToString メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このインスタンスの数値を等価の文字列形式に変換します。
オーバーロード
| 名前 | 説明 |
|---|---|
| ToString(IFormatProvider) |
指定したカルチャ固有の書式情報を使用して、このインスタンスの数値を等価の文字列形式に変換します。 |
| ToString() |
このインスタンスの数値を等価の文字列形式に変換します。 |
| ToString(String) |
指定した形式を使用して、このインスタンスの数値を等価の文字列形式に変換します。 |
| ToString(String, IFormatProvider) |
指定した書式とカルチャ固有の書式情報を使用して、このインスタンスの数値を等価の文字列形式に変換します。 |
ToString(IFormatProvider)
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
指定したカルチャ固有の書式情報を使用して、このインスタンスの数値を等価の文字列形式に変換します。
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);public:
System::String ^ ToString(IFormatProvider ^ provider);public string ToString(IFormatProvider provider);public string ToString(IFormatProvider? provider);override this.ToString : IFormatProvider -> stringPublic Function ToString (provider As IFormatProvider) As Stringパラメーター
- provider
- IFormatProvider
カルチャ固有の書式設定情報を提供する IFormatProvider 。
返品
providerで指定された、このインスタンスの値の文字列形式。
実装
例
次の例では、 Int16 値の配列を反復処理し、異なる形式プロバイダーを使用して Int16.ToString(IFormatProvider) メソッドを呼び出して、それぞれの値をコンソールに表示します。 既定の "G" 書式指定子によって定義される単純な書式設定のため、 Int16 値ごとに生成される書式設定された文字列は、 provider パラメーターの値に関係なく同じです。
short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
foreach (CultureInfo provider in providers)
{
Console.Write("{0, 6} ({1}) ",
int16Value.ToString(provider),
provider.Name);
}
Console.WriteLine();
}
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
for int16Value in numbers do
for provider in providers do
printf $"{int16Value.ToString provider, 6} ({provider.Name}) "
printfn ""
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
For Each provider As CultureInfo In providers
Console.Write("{0, 6} ({1}) ", _
int16Value.ToString(provider), _
provider.Name)
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
' 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
' 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
' 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
注釈
ToString(IFormatProvider) メソッドは、指定したカルチャのInt16 オブジェクトを使用して、既定の ("G"、または一般) 形式でNumberFormatInfo値を書式設定します。 別の形式または現在のカルチャを指定する場合は、次のように、 ToString メソッドの他のオーバーロードを使用します。
| 書式を使用するには | カルチャの場合 | オーバーロードを使用する |
|---|---|---|
| 既定の ("G") 形式 | 既定の (現在の) カルチャ | ToString() |
| 特定の形式 | 既定の (現在の) カルチャ | ToString(String) |
| 特定の形式 | 特定のカルチャ | ToString(String, IFormatProvider) |
.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。
数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および 「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定 の種類」を参照してください。
provider パラメーターは、IFormatProvider メソッドがIFormatProvider.GetFormat オブジェクトを返すNumberFormatInfo実装です。 通常、 provider は NumberFormatInfo オブジェクトまたは CultureInfo オブジェクトです。
NumberFormatInfo オブジェクトは、このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供します。
providerがnullされている場合、このインスタンスは現在のカルチャのNumberFormatInfo オブジェクトで書式設定されます。
こちらもご覧ください
適用対象
ToString()
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
このインスタンスの数値を等価の文字列形式に変換します。
public:
override System::String ^ ToString();public override string ToString();override this.ToString : unit -> stringPublic Overrides Function ToString () As String返品
このインスタンスの値の文字列表現。値が負の場合は負符号、先頭にゼロがない 0 から 9 までの数字のシーケンスで構成されます。
例
次の例では、 ToString() メソッドを使用して、 Int16 値の配列をコンソールに表示します。
short[] numbers = {0, 14624, 13982, short.MaxValue,
short.MinValue, -16667};
foreach (short number in numbers)
{
Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]
for number in numbers do
printfn $"{number.ToString()}"
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
Short.MinValue, -16667}
For Each number As Short In numbers
Console.WriteLine(number.ToString())
Next
' The example displays the following output to the console:
' 0
' 14624
' 13982
' 32767
' -32768
' -16667
注釈
ToString() メソッドは、現在のカルチャのInt16 オブジェクトを使用して、既定の ("G"、または一般) 形式でNumberFormatInfo値を書式設定します。 別の形式またはカルチャを指定する場合は、次のように、 ToString メソッドの他のオーバーロードを使用します。
| 書式を使用するには | カルチャの場合 | オーバーロードを使用する |
|---|---|---|
| 既定の ("G") 形式 | 特定のカルチャ | ToString(IFormatProvider) |
| 特定の形式 | 既定の (現在の) カルチャ | ToString(String) |
| 特定の形式 | 特定のカルチャ | ToString(String, IFormatProvider) |
.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。
数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および 「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定 の種類」を参照してください。
こちらもご覧ください
適用対象
ToString(String)
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
指定した形式を使用して、このインスタンスの数値を等価の文字列形式に変換します。
public:
System::String ^ ToString(System::String ^ format);public string ToString(string format);public string ToString(string? format);override this.ToString : string -> stringPublic Function ToString (format As String) As Stringパラメーター
- format
- String
数値書式指定文字列。
返品
formatで指定された、このインスタンスの値の文字列形式。
例
次の例では、2 つの Int16 値を初期化し、サポートされている各標準書式指定文字列と複数のカスタム書式指定文字列を使用してコンソールに表示します。 この例は、現在のカルチャとして en-US を使用して実行されます。
Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}",
format,
values[0].ToString(format),
values[1].ToString(format));
}
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
let values = [| -23805s; 32194s |]
let formats =
[ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
printfn $"'{format,2}' format specifier: {values[0].ToString format,17} {values[1].ToString format,17}"
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}", _
format, _
values(0).ToString(format), _
values(1).ToString(format))
Next
' The example displays the following output to the console:
' 'C4' format specifier: ($23,805.0000) $32,194.0000
' 'D6' format specifier: -023805 032194
' 'e1' format specifier: -2.4e+004 3.2e+004
' 'E2' format specifier: -2.38E+004 3.22E+004
' 'F1' format specifier: -23805.0 32194.0
' ' G' format specifier: -23805 32194
' 'N1' format specifier: -23,805.0 32,194.0
' 'P0' format specifier: -2,380,500 % 3,219,400 %
' 'X4' format specifier: A303 7DC2
' '000000.0000' format specifier: -023805.0000 032194.0000
' '##000.0' format specifier: -23805.0 32194.0
注釈
ToString(String) メソッドは、現在のカルチャの規則を表すInt16 オブジェクトを使用して、指定した形式でNumberFormatInfo値を書式設定します。 既定の ("G"、または一般的な) 形式を使用する場合、または別のカルチャを指定する場合は、次のように、 ToString メソッドの他のオーバーロードを使用します。
| 書式を使用するには | カルチャの場合 | オーバーロードを使用する |
|---|---|---|
| 既定の ("G") 形式 | 既定の (現在の) カルチャ | ToString() |
| 既定の ("G") 形式 | 特定のカルチャ | ToString(IFormatProvider) |
| 特定の形式 | 特定のカルチャ | ToString(String, IFormatProvider) |
formatパラメーターには、標準またはカスタムの数値書式指定文字列を指定できます。 すべてのカスタム数値書式指定文字と同様に、"R" (または "r") 以外のすべての標準の数値書式指定文字列がサポートされています。
formatがnullまたは空の文字列の場合、このインスタンスの戻り値は一般的な数値書式指定子 ("G") で書式設定されます。
.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。
数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および 「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定 の種類」を参照してください。
このインスタンスの戻り値は、現在のカルチャの NumberFormatInfo で書式設定されます。
こちらもご覧ください
適用対象
ToString(String, IFormatProvider)
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
- ソース:
- Int16.cs
指定した書式とカルチャ固有の書式情報を使用して、このインスタンスの数値を等価の文字列形式に変換します。
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);public string ToString(string format, IFormatProvider provider);public string ToString(string? format, IFormatProvider? provider);override this.ToString : string * IFormatProvider -> stringPublic Function ToString (format As String, provider As IFormatProvider) As Stringパラメーター
- format
- String
数値書式指定文字列。
- provider
- IFormatProvider
カルチャ固有の書式設定情報を提供するオブジェクト。
返品
formatおよびproviderで指定された、このインスタンスの値の文字列形式。
実装
例
次の例では、4 つの異なるカルチャでサポートされている各標準書式指定文字列を使用して、 Int16 値を表示します。
Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
// Display the value for each provider on the same line.
Console.Write("{0,-12}", format);
foreach (CultureInfo provider in providers)
{
Console.Write("{0,12} ",
value.ToString(format, provider));
}
Console.WriteLine();
}
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
let value = 14603
let formats =
[ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
// Display header.
printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
// Display a value using each format string.
for format in formats do
// Display the value for each provider on the same line.
printf $"{format,-12}"
for provider in providers do
printf $"{value.ToString(format, provider),12} "
printfn ""
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
providers(2), providers(3))
Console.WriteLine()
' Display a value using each format string.
For Each format As String In formats
' Display the value for each provider on the same line.
Console.Write("{0,-12}", format)
For Each provider As CultureInfo In providers
Console.Write("{0,12} ", _
value.ToString(format, provider))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' en-US fr-FR de-DE es-ES
'
' C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
' D6 014603 014603 014603 014603
' e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
' E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
' F1 14603.0 14603,0 14603,0 14603,0
' G 14603 14603 14603 14603
' N1 14,603.0 14 603,0 14.603,0 14.603,0
' P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
' X4 390B 390B 390B 390B
' 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
' ##000.0 14603.0 14603,0 14603,0 14603,0
注釈
ToString(String, IFormatProvider) メソッドは、指定したカルチャのInt16 オブジェクトを使用して、指定した形式でNumberFormatInfo値を書式設定します。 既定の形式またはカルチャ設定を使用する場合は、次のように、 ToString メソッドの他のオーバーロードを使用します。
| 書式を使用するには | カルチャの場合 | オーバーロードを使用する |
|---|---|---|
| 既定の ("G") 形式 | 既定の (現在の) カルチャ | ToString() |
| 既定の ("G") 形式 | 特定のカルチャ | ToString(IFormatProvider) |
| 特定の形式 | 既定の (現在の) カルチャ | ToString(String) |
formatパラメーターには、標準またはカスタムの数値書式指定文字列を指定できます。 すべてのカスタム数値書式指定文字と同様に、"R" (または "r") 以外のすべての標準の数値書式指定文字列がサポートされています。
formatがnullまたは空の文字列 ("") の場合、このメソッドによって返される文字列は、一般的な数値書式指定子 ("G") で書式設定されます。
.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。
数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および 「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定 の種類」を参照してください。
provider パラメーターは、IFormatProvider実装です。 その GetFormat メソッドは、このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する NumberFormatInfo オブジェクトを返します。
IFormatProviderを実装するオブジェクトには、次のいずれかを指定できます。
書式設定規則を使用するカルチャを表す CultureInfo オブジェクト。
この値の特定の数値書式情報を含む NumberFormatInfo オブジェクト。
IFormatProviderを実装するカスタム オブジェクト。
providerがnullされている場合、またはNumberFormatInfo オブジェクトをproviderから取得できない場合、戻り値は現在のカルチャのNumberFormatInfoで書式設定されます。
こちらもご覧ください
- Parse(String)
- .NET での型の書式設定
- 標準の数値書式指定文字列
- カスタム数値形式文字列
- 方法: 先頭にゼロを付けて数値を埋め込む
- サンプル: .NET Core WinForms 書式設定ユーティリティ (C#)
- サンプル: .NET Core WinForms 書式設定ユーティリティ (Visual Basic)
