Byte.ToString メソッド

定義

名前空間:: System

アセンブリ:: mscorlib.dll, System.Runtime.dll

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の Byte オブジェクトの値を等価の文字列形式に変換します。

オーバーロード

名前	説明
ToString()	現在の Byte オブジェクトの値を等価の文字列形式に変換します。
ToString(IFormatProvider)	指定したカルチャ固有の書式設定情報を使用して、現在の Byte オブジェクトの数値を等価の文字列形式に変換します。
ToString(String)	指定した形式を使用して、現在の Byte オブジェクトの値を等価の文字列形式に変換します。
ToString(String, IFormatProvider)	現在の Byte オブジェクトの値を、指定した書式およびカルチャ固有の書式設定情報を使用して、同等の文字列形式に変換します。

ToString()

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

現在の Byte オブジェクトの値を等価の文字列形式に変換します。

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

返品

String

このオブジェクトの値の文字列表現。0 から 9 の範囲の数字のシーケンスで構成され、先頭にゼロがありません。

例

次の例では、バイト値の配列を表示します。この例では、 ToString() メソッドが明示的に呼び出されないことに注意してください。代わりに、複合書式設定機能を使用するため、暗黙的に呼び出されます。F# の例では文字列補間を使用します。

byte[] bytes = {0, 1, 14, 168, 255};
foreach (byte byteValue in bytes)
   Console.WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

let bytes = [| 0; 1; 14; 168; 255 |]
for byteValue in bytes do
    printfn $"{byteValue}"

// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

Dim bytes() As Byte = {0, 1, 14, 168, 255}
For Each byteValue As Byte In Bytes
   Console.WriteLine(byteValue)
Next   
' The example displays the following output to the console if the current
' culture is en-US:
'       0
'       1
'       14
'       168
'       255

注釈

戻り値は、一般的な数値書式指定子 ("G") とスレッドの現在のカルチャの NumberFormatInfo オブジェクトで書式設定されます。 Byte値の文字列形式の書式設定を定義するには、ToString メソッドを呼び出します。 Byte値の文字列形式を作成するために使用する書式指定子とカルチャの両方を定義するには、ToString メソッドを呼び出します。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定の種類」を参照してください。

スレッドの現在のカルチャについては、「 Thread.CurrentCulture」を参照してください。

適用対象

ToString(IFormatProvider)

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

指定したカルチャ固有の書式設定情報を使用して、現在の Byte オブジェクトの数値を等価の文字列形式に変換します。

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 -> string

Public Function ToString (provider As IFormatProvider) As String

パラメーター

provider: IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

返品

String

provider パラメーターで指定された形式での、このオブジェクトの値の文字列形式。

実装

ToString(IFormatProvider)

例

次の例では、バイト値の配列を反復処理し、異なる形式プロバイダーを使用して ToString(IFormatProvider) メソッドを呼び出して、各バイト値をコンソールに表示します。

byte[] bytes = {0, 1, 14, 168, 255};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (byte byteValue in bytes)
{
   foreach (CultureInfo provider in providers)
      Console.Write("{0,3} ({1})      ",
                    byteValue.ToString(provider), provider.Name);

   Console.WriteLine();
}
// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

let bytes = [| 0; 1; 14; 168; 255 |]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for byteValue in bytes do
    for provider in providers do
        printf $"{byteValue.ToString provider,3} ({provider.Name})      " 

    printfn ""

// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Dim bytes() As Byte = {0, 1, 14, 168, 255}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each byteValue As Byte In bytes
   For Each provider As CultureInfo In providers
      Console.Write("{0,3} ({1})      ", byteValue.ToString(provider), provider.Name)
   Next
   Console.WriteLine()                                        
Next
' The example displays the following output to the console:
'      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
'      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
'     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
'    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
'    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

注釈

戻り値は、一般的な数値書式指定子 ("G") で書式設定されます。

provider パラメーターは、IFormatProvider インターフェイスを実装するオブジェクトです。その GetFormat メソッドは、このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する NumberFormatInfo オブジェクトを返します。 IFormatProviderを実装するオブジェクトには、次のいずれかを指定できます。

書式設定規則を使用するカルチャを表す CultureInfo オブジェクト。
この値の特定の数値書式情報を含む NumberFormatInfo オブジェクト。
IFormatProviderを実装するカスタムオブジェクト。

providerがnullの場合、またはNumberFormatInfo オブジェクトをproviderから取得できない場合、戻り値はスレッドの現在のカルチャのNumberFormatInfo オブジェクトを使用して書式設定されます。スレッドの現在のカルチャについては、「 Thread.CurrentCulture」を参照してください。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定の種類」を参照してください。

こちらもご覧ください

適用対象

ToString(String)

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

指定した形式を使用して、現在の Byte オブジェクトの値を等価の文字列形式に変換します。

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(string format);

public string ToString(string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

パラメーター

format: String

数値書式指定文字列。

返品

String

Byte パラメーターで指定された形式の現在のformat オブジェクトの文字列形式。

例外

FormatException

format には、サポートされていない指定子が含まれています。サポートされている書式指定子は、「解説」セクションに記載されています。

例

次の例では、 Byte 値を初期化し、サポートされている各標準書式指定文字列とカスタム書式指定文字列を使用してコンソールに表示します。この例は、現在のカルチャとして en-US を使用して実行されます。

string[] formats = {"C3", "D4", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "0000.0000"};
byte number = 240;
foreach (string format in formats)
   Console.WriteLine("'{0}' format specifier: {1}",
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

let formats = 
    [ "C3"; "D4"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "0000.0000" ]
let number = 240uy
for format in formats do
    printfn $"'{format}' format specifier: {number.ToString format}"

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

Dim formats() As String = {"C3", "D4", "e1", "E2", "F1", "G", _
                           "N1", "P0", "X4", "0000.0000"}
Dim number As Byte = 240
For Each format As String In formats
   Console.WriteLine("'{0}' format specifier: {1}", _
                     format, number.ToString(format))
Next  
' The example displays the following output to the console if the
' current culture is en-us:
'       'C3' format specifier: $240.000
'       'D4' format specifier: 0240
'       'e1' format specifier: 2.4e+002
'       'E2' format specifier: 2.40E+002
'       'F1' format specifier: 240.0       
'       'G' format specifier: 240
'       'N1' format specifier: 240.0
'       'P0' format specifier: 24,000 %
'       'X4' format specifier: 00F0
'       '0000.0000' format specifier: 0240.0000

注釈

formatパラメーターには、標準またはカスタムの数値書式指定文字列を指定できます。すべてのカスタム数値書式指定文字と同様に、"R" (または "r") 以外のすべての標準の数値書式指定文字列がサポートされています。 formatがnullまたは空の文字列 ("") の場合、戻り値は一般的な数値書式指定子 ("G") で書式設定されます。

この関数の戻り値は、スレッドの現在のカルチャの NumberFormatInfo オブジェクトを使用して書式設定されます。スレッドの現在のカルチャについては、「 Thread.CurrentCulture」を参照してください。現在のカルチャ以外のカルチャの書式設定情報を提供するには、 Byte.ToString(String, IFormatProvider) メソッドを呼び出します。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定の種類」を参照してください。

こちらもご覧ください

方法: 先頭にゼロを付けて数値を埋め込む

適用対象

ToString(String, IFormatProvider)

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

ソース:: Byte.cs

現在の Byte オブジェクトの値を、指定した書式およびカルチャ固有の書式設定情報を使用して、同等の文字列形式に変換します。

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 -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

パラメーター

format: String

標準またはカスタムの数値書式指定文字列。

provider: IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

返品

String

現在の Byte オブジェクトの文字列形式。 format パラメーターと provider パラメーターで指定された形式です。

実装

ToString(String, IFormatProvider)

例外

FormatException

format には、サポートされていない指定子が含まれています。サポートされている書式指定子は、「解説」セクションに記載されています。

例

次の例では、標準の "N" 書式指定文字列と 4 つの異なる CultureInfo オブジェクトを使用して、バイト値の文字列表現をコンソールに表示します。

byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("es-es"),
                           new CultureInfo("de-de")};

foreach (CultureInfo provider in providers)
   Console.WriteLine("{0} ({1})",
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

let byteValue = 250uy
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "es-es"
      CultureInfo "de-de" ]

for provider in providers do
    printfn $"""{byteValue.ToString("N2", provider)} ({provider.Name})"""

// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

Dim byteValue As Byte = 250
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("es-es"), _
                                  New CultureInfo("de-de")} 
For Each provider As CultureInfo In providers 
   Console.WriteLine("{0} ({1})", _
                     byteValue.ToString("N2", provider), provider.Name)
Next   
' The example displays the following output to the console:
'       250.00 (en-US)
'       250,00 (fr-FR)
'       250,00 (es-ES)
'       250,00 (de-DE)

注釈

ToString(String, IFormatProvider) メソッドは、指定したカルチャの指定した形式でByte値を書式設定します。現在のカルチャの既定の ("G") 形式を使用して数値を書式設定するには、 ToString() メソッドを呼び出します。現在のカルチャの指定した形式を使用して数値を書式設定するには、 ToString(String) メソッドを呼び出します。

formatパラメーターには、標準またはカスタムの数値書式指定文字列を指定できます。すべてのカスタム数値書式指定文字と同様に、"R" (または "r") 以外のすべての標準の数値書式指定文字列がサポートされています。 formatがnullまたは空の文字列 ("") の場合、このメソッドの戻り値は一般的な数値書式指定子 ("G") で書式設定されます。

書式設定規則を使用するカルチャを表す CultureInfo オブジェクト。
この値の特定の数値書式情報を含む NumberFormatInfo オブジェクト。
IFormatProviderを実装するカスタムオブジェクト。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
書式設定の詳細については、「書式設定の種類」を参照してください。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?