Byte.ToString メソッド

リファレンス

定義

名前空間:: System

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

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

ToString(IFormatProvider)

指定したカルチャ固有の書式設定情報を使用して、現在の 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) 表示します。

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
array<CultureInfo^>^ providers = {gcnew CultureInfo("en-us"), 
                                  gcnew CultureInfo("fr-fr"), 
                                  gcnew CultureInfo("de-de"), 
                                  gcnew CultureInfo("es-es")};
for each (Byte byteValue in bytes)
{
   for each (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)

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するカスタムオブジェクト。

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

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

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

こちらもご覧ください

適用対象

ToString(String)

指定した書式を使用して、現在の 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 を使用して実行されます。

array<String^>^ formats = gcnew array<String^> {"C3", "D4", "e1", "E2", "F1", "G", "N1", 
                                                "P0", "X4", "0000.0000"};
Byte number = 240;
for each (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

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") 以外のすべての標準の数値書式指定文字列がサポートされています。が null または空の文字列 ("") の場合format、戻り値は一般的な数値書式指定子 ("G") で書式設定されます。

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

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

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

こちらもご覧ください

方法: 数値に先行するゼロを埋め込む

適用対象

ToString(String, IFormatProvider)

指定した形式およびカルチャ固有の書式設定情報を使用して、現在の 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;
array<CultureInfo^>^ providers = gcnew array<CultureInfo^> { gcnew CultureInfo("en-us"), 
                                                             gcnew CultureInfo("fr-fr"), 
                                                             gcnew CultureInfo("es-es"), 
                                                             gcnew CultureInfo("de-de")}; 

for each (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)

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") 以外のすべての標準の数値書式指定文字列がサポートされています。が null または空の文字列 ("") の場合format、このメソッドの戻り値は、一般的な数値書式指定子 ("G") で書式設定されます。

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

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

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

こちらもご覧ください

適用対象

ToString()

現在の 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# の例では文字列補間を使用します。

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
for each (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

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。

適用対象

Byte.ToString メソッド

定義

オーバーロード

ToString(IFormatProvider)

パラメーター

戻り値

実装

例

注釈

こちらもご覧ください

適用対象

ToString(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ToString(String, IFormatProvider)

パラメーター

戻り値

実装

例外

例

注釈

こちらもご覧ください

適用対象

ToString()

戻り値

例

注釈

適用対象

フィードバック

その他のリソース