Byte.ToString メソッド

定義

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

オーバーロード

ToString(IFormatProvider)

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

ToString(String)

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

ToString(String, IFormatProvider)

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

ToString()

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

ToString(IFormatProvider)

ソース:
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

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

戻り値

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

実装

次の例では、バイト値の配列を反復処理し、異なる形式プロバイダーで メソッドを呼び出して、それぞれの値をコンソールに 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 オブジェクトです。 そのメソッドは GetFormatNumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する オブジェクトを返します。 を実装する IFormatProvider オブジェクトには、次のいずれかを指定できます。

  • CultureInfo書式設定ルールを使用するカルチャを表す オブジェクト。

  • NumberFormatInfoこの値の特定の数値書式情報を含む オブジェクト。

  • を実装 IFormatProviderするカスタム オブジェクト。

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

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

こちらもご覧ください

適用対象

ToString(String)

ソース:
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

数値書式指定文字列。

戻り値

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

例外

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

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

戻り値

現在の Byte オブジェクトの文字列形式を、format および provider パラメーターで指定された書式で表現した値。

実装

例外

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") で書式設定されます。

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

  • CultureInfo書式設定ルールを使用するカルチャを表す オブジェクト。

  • NumberFormatInfoこの値の特定の数値書式情報を含む オブジェクト。

  • を実装 IFormatProviderするカスタム オブジェクト。

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

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

こちらもご覧ください

適用対象

ToString()

ソース:
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

戻り値

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

適用対象