Byte.ToString 메서드

정의

현재 Byte 개체의 값을 해당하는 문자열 표현으로 변환합니다.

오버로드

ToString()

현재 Byte 개체의 값을 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)

지정된 문화권별 형식 지정 정보를 사용하여 현재 Byte 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String)

지정된 형식을 사용하여 현재 Byte 개체의 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 지정 정보를 사용하여 현재 Byte 개체의 값을 해당 문자열 표현으로 변환합니다.

ToString()

현재 Byte 개체의 값을 해당하는 문자열 표현으로 변환합니다.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

반환

String

이 개체의 값에 대한 문자열 표현이며, 맨 앞에 0이 오지 않고 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.

적용 대상

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) 하 여 콘솔에 각 표시 합니다.

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 개체의 문자열 표현입니다.

예외

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

Byteformat 매개 변수에 지정된 형식으로 현재 provider 개체를 나타낸 문자열 표현입니다.

구현

예외

format에 지원되지 않는 지정자가 포함되어 있습니다. 지원되는 형식 지정자가 설명 섹션에 나열되어 있습니다.

예제

다음 예제에서는 표준 "N" 형식 문자열과 네 개의 서로 다른 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. 해당 메서드는 GetFormat 이 메서드에서 NumberFormatInfo 반환하는 문자열의 형식에 대한 문화권별 정보를 제공하는 개체를 반환합니다. 를 구현하는 개체는 IFormatProvider 다음 중 한 가지일 수 있습니다.

  • CultureInfo 서식 규칙을 사용할 문화권을 나타내는 개체입니다.

  • NumberFormatInfo 이 값에 대한 특정 숫자 서식 정보를 포함하는 개체입니다.

  • 를 구현하는 사용자 지정 개체입니다 IFormatProvider.

null 또는 에서 개체를 NumberFormatInfo 가져올 provider수 없는 경우 provider 반환 값은 스레드 현재 문화권에 대한 개체를 사용하여 NumberFormatInfo 형식이 지정됩니다. 스레드 현재 문화권에 대한 자세한 내용은 를 참조하세요 Thread.CurrentCulture.

.NET은 다음 서식 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

추가 정보

적용 대상