Int64.ToString 메서드

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

오버로드

ToString(IFormatProvider)	지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.
ToString()	이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.
ToString(String)	지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.
ToString(String, IFormatProvider)	지정된 형식 및 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)

Source:: Int64.cs

Source:: Int64.cs

Source:: Int64.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 -> string

Public Function ToString (provider As IFormatProvider) As String

매개 변수

provider: IFormatProvider

문화권별 서식 정보를 제공하는 IFormatProvider.

반환

String

provider지정한 이 인스턴스 값의 문자열 표현입니다.

구현

ToString(IFormatProvider)

예제

다음 예제에서는 여러 다른 문화권을 나타내는 CultureInfo 개체를 사용하여 Int64 값의 문자열 표현을 표시합니다.

long value = -16325901;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325901
//       -16325901
//       -16325901

let value = -16325901L
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB" )}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE" )}"""
// This example displays the following output to the console:
//       -16325901
//       -16325901
//       -16325901

Dim value As Long = -16325801
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325901
'       -16325901
'       -16325901

설명

ToString(IFormatProvider) 메서드는 지정된 문화권의 NumberFormatInfo 개체를 사용하여 기본("G" 또는 일반) 형식으로 Int64 값의 형식을 지정합니다. 다른 형식 또는 현재 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면	문화권의 경우	오버로드 사용
기본("G") 형식	기본(현재) 문화권	ToString()
특정 형식	기본(현재) 문화권	ToString(String)
특정 형식	특정 문화권	ToString(String, IFormatProvider)

provider 매개 변수는 IFormatProvider 인터페이스를 구현하는 개체입니다. 해당 GetFormat 메서드는 이 메서드에서 반환되는 문자열 형식에 대한 문화권별 정보를 제공하는 NumberFormatInfo 개체를 반환합니다. IFormatProvider 구현하는 개체는 다음 중 어느 것일 수 있습니다.

서식 규칙을 사용할 문화권을 나타내는 CultureInfo 개체입니다.
이 값에 대한 특정 숫자 서식 정보를 포함하는 NumberFormatInfo 개체입니다.
IFormatProvider 구현하고 GetFormat 메서드가 서식 정보를 제공하는 NumberFormatInfo 개체를 반환하는 사용자 지정 개체입니다.

provider null 또는 providerNumberFormatInfo 개체를 가져올 수 없는 경우 반환 값은 현재 문화권에 대한 NumberFormatInfo 개체로 서식이 지정됩니다.

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

숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열 및 사용자 지정 숫자 서식 문자열참조하세요.
서식 지정에 대한 자세한 내용은 형식참조하세요.

추가 정보

Parse(String)
String
.NET 형식

적용 대상

ToString()

Source:: Int64.cs

Source:: Int64.cs

Source:: Int64.cs

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

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() 메서드를 사용하여 Int64 값을 표시합니다. 또한 여러 표준 형식 지정자를 사용하여 생성된 Int64 값의 문자열 표현도 표시합니다. 예제는 en-US 문화권의 서식 규칙을 사용하여 표시됩니다.

long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325091
Console.WriteLine(value.ToString("C"));         // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325091
Console.WriteLine(value.ToString("F"));         // Displays -16325091.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325,091.00
Console.WriteLine(value.ToString("N0"));         // Displays -16,325,091
Console.WriteLine(value.ToString("X"));         // Displays FFFFFFFFFF06E61D

let value = -16325091L
// Display value using default ToString method.
printfn $"{value.ToString()}"            // Displays -16325091
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""         // Displays -16325091
printfn $"""{value.ToString "C"}"""         // Displays ($16,325,091.00)
printfn $"""{value.ToString "D"}"""         // Displays -16325091
printfn $"""{value.ToString "F"}"""         // Displays -16325091.00
printfn $"""{value.ToString "N"}"""         // Displays -16,325,091.00
printfn $"""{value.ToString "N0"}"""        // Displays -16,325,091
printfn $"""{value.ToString "X"}"""         // Displays FFFFFFFFFF06E61D

Dim value As Long = -16325091
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325091
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325091
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325091
Console.WriteLine(value.ToString("F"))         ' Displays -16325091.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325091.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFFFFFFF06E61D

설명

ToString() 메서드는 현재 문화권의 NumberFormatInfo 개체를 사용하여 기본("G" 또는 일반) 형식으로 Int64 값의 형식을 지정합니다. 다른 형식이나 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면	문화권의 경우	오버로드 사용
기본("G") 형식	특정 문화권	ToString(IFormatProvider)
특정 형식	기본(현재) 문화권	ToString(String)
특정 형식	특정 문화권	ToString(String, IFormatProvider)

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

숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열 및 사용자 지정 숫자 서식 문자열참조하세요.
서식 지정에 대한 자세한 내용은 형식참조하세요.

추가 정보

Parse(String)
String
.NET 형식

적용 대상

ToString(String)

Source:: Int64.cs

Source:: Int64.cs

Source:: Int64.cs

지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

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

format지정한 이 인스턴스 값의 문자열 표현입니다.

예외

FormatException

format 잘못되었거나 지원되지 않습니다.

예제

다음 예제에서는 두 개의 사용자 지정 숫자 형식 문자열과 함께 지원되는 각 표준 숫자 형식 지정자를 사용하여 Int64 값을 표시합니다. 숫자 값을 문자열로 변환할 때 예제에서는 en-US 문화권의 서식 지정 규칙을 사용합니다.

long value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000.0).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFFFFFFFFFC03B

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00

let value = -16325L

// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: -16325

let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: ($16,325.00)

let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    D8: -00016325

let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E4: -1.6325E+004

let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    e3: -1.633e+004

let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: -16325.00

let specifier = "N"
printfn $"{specifier}: {value.ToString specifier }"
// Displays:    N: -16,325.00

let specifier = "P"
printfn $"{specifier}: {(float value / 100000.0).ToString specifier}"
// Displays:    P: -16.33 %

let specifier = "X"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays:    X: FFFFFFFFFFFFC03B

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays:    0,0.000: -16,325.000

let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1L).ToString specifier}"
// Displays:    #,#.00#(#,#.00#): 16,325.00

Dim value As Long = -16325
Dim specifier As String

' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays:    P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    X: FFFFFFFFFFFFC03B

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): 16,325.00

설명

ToString(String) 메서드는 현재 문화권의 규칙을 나타내는 NumberFormatInfo 개체를 사용하여 지정된 형식으로 Int64 값의 서식을 지정합니다. 기본("G" 또는 일반) 형식을 사용하거나 다른 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면	문화권의 경우	오버로드 사용
기본("G") 형식	기본(현재) 문화권	ToString()
기본("G") 형식	특정 문화권	ToString(IFormatProvider)
특정 형식	특정 문화권	ToString(String, IFormatProvider)

format 매개 변수는 사용자 지정 숫자 형식 지정자의 조합뿐만 아니라 "R"을 제외한 유효한 표준 숫자 형식 지정자일 수 있습니다. format null 또는 빈 문자열("")인 경우 이 인스턴스의 반환 값은 일반 숫자 형식 지정자("G")로 서식이 지정됩니다.

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

숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열 사용자 지정 숫자 서식 문자열.
서식 지정에 대한 자세한 내용은 형식참조하세요.

이 인스턴스의 반환 값은 현재 문화권에 대한 NumberFormatInfo 서식이 지정됩니다.

추가 정보

Parse(String)
String
.NET 형식
표준 숫자 형식 문자열
사용자 지정 숫자 형식 문자열
방법: 앞에 오는 0으로 숫자 채우기

적용 대상

ToString(String, IFormatProvider)

Source:: Int64.cs

Source:: Int64.cs

Source:: Int64.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 -> string

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

매개 변수

format: String

숫자 형식 문자열입니다.

provider: IFormatProvider

이 인스턴스에 대한 문화권별 서식 정보를 제공하는 개체입니다.

반환

String

format 및 provider지정한 이 인스턴스 값의 문자열 표현입니다.

구현

ToString(String, IFormatProvider)

예외

FormatException

format 잘못되었거나 지원되지 않습니다.

예제

다음 예제에서는 세 가지 문화권에 대해 지원되는 각 표준 숫자 형식 지정자를 사용하여 양수 및 음수 값을 표시합니다.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "N0", "P", "X8"};

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
                        specifier, culture.Name,
                        positiveNumber.ToString(specifier, culture),
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//    C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1 679,00        -3 045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//
//    N0 format using en-US culture:         1,679           -3,045
//    N0 format using fr-FR culture:         1 679           -3 045
//    N0 format using es-ES culture:         1.679           -3.045
//
//    P format using en-US culture:      167,900.00%     -304,500.00%
//    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//    X8 format using en-US culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US"
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]

let positiveNumber = 1679L
let negativeNumber = -3045L
let specifiers = [| "G"; "C"; "D8"; "E2"; "F"; "N"; "N0"; "P"; "X8" |]

for specifier in specifiers do
    for culture in cultures do
        // Display values with "G" format specifier.
        printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"           
    printfn ""

// The example displays the following output to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//    C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1 679,00        -3 045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//
//    N0 format using en-US culture:         1,679           -3,045
//    N0 format using fr-FR culture:         1 679           -3 045
//    N0 format using es-ES culture:         1.679           -3.045
//
//    P format using en-US culture:      167,900.00%     -304,500.00%
//    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//    X8 format using en-US culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

' Define cultures whose formatting conventions are to be used.
Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                 CultureInfo.CreateSpecificCulture("fr-FR"), _
                                 CultureInfo.CreateSpecificCulture("es-ES") }
Dim positiveNumber As Long = 1679
Dim negativeNumber As Long = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"} 

For Each specifier As String In specifiers
   For Each culture As CultureInfo In Cultures
      ' Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}", _ 
                        specifier, culture.Name, _
                        positiveNumber.ToString(specifier, culture), _
                        negativeNumber.ToString(specifier, culture))

   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'
'    G format using en-US culture:             1679            -3045
'    G format using fr-FR culture:             1679            -3045
'    G format using es-ES culture:             1679            -3045
'
'    C format using en-US culture:        $1,679.00      ($3,045.00)
'    C format using fr-FR culture:       1 679,00 €      -3 045,00 €
'    C format using es-ES culture:       1.679,00 €      -3.045,00 €
'
'    D8 format using en-US culture:         00001679        -00003045
'    D8 format using fr-FR culture:         00001679        -00003045
'    D8 format using es-ES culture:         00001679        -00003045
'
'    E2 format using en-US culture:        1.68E+003       -3.05E+003
'    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
'    E2 format using es-ES culture:        1,68E+003       -3,05E+003
'
'    F format using en-US culture:          1679.00         -3045.00
'    F format using fr-FR culture:          1679,00         -3045,00
'    F format using es-ES culture:          1679,00         -3045,00
'
'    N format using en-US culture:         1,679.00        -3,045.00
'    N format using fr-FR culture:         1 679,00        -3 045,00
'    N format using es-ES culture:         1.679,00        -3.045,00
'
'    P format using en-US culture:      167,900.00%     -304,500.00%
'    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
'    P format using es-ES culture:     167.900,00 %    -304.500,00 %
'
'    X8 format using en-US culture:         0000068F FFFFFFFFFFFFF41B
'    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
'    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

설명

ToString(String, IFormatProvider) 메서드는 지정된 문화권의 NumberFormatInfo 개체를 사용하여 지정된 형식으로 Int64 값의 서식을 지정합니다. 기본 형식 또는 문화권 설정을 사용하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면	문화권의 경우	오버로드 사용
기본("G") 형식	기본(현재) 문화권	ToString()
기본("G") 형식	특정 문화권	ToString(IFormatProvider)
특정 형식	기본(현재) 문화권	ToString(String)

format 매개 변수는 표준 또는 사용자 지정 숫자 형식 문자열일 수 있습니다. 모든 사용자 지정 숫자 서식 문자와 마찬가지로 "R" 또는 "r"을 제외한 모든 표준 숫자 서식 문자열이 지원됩니다. format null 또는 빈 문자열("")인 경우 이 인스턴스의 반환 값은 일반 숫자 형식 지정자("G")로 서식이 지정됩니다.

서식 규칙을 사용할 문화권을 나타내는 CultureInfo 개체입니다.
이 값에 대한 특정 숫자 서식 정보를 포함하는 NumberFormatInfo 개체입니다.
IFormatProvider 구현하고 GetFormat 메서드가 서식 정보를 제공하는 NumberFormatInfo 개체를 반환하는 사용자 지정 개체입니다.

provider null 또는 providerNumberFormatInfo 개체를 가져올 수 없는 경우 이 인스턴스의 반환 값은 현재 문화권에 대한 NumberFormatInfo 서식이 지정됩니다.

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

숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열 및 사용자 지정 숫자 서식 문자열참조하세요.
서식 지정에 대한 자세한 내용은 형식참조하세요.

추가 정보

Parse(String)
.NET 형식
표준 숫자 형식 문자열
사용자 지정 숫자 형식 문자열
방법: 앞에 오는 0으로 숫자 채우기
샘플: .NET Core WinForms 서식 유틸리티(C#)
샘플: .NET Core WinForms 서식 유틸리티(Visual Basic)

적용 대상

다음을 통해 공유

Int64.ToString 메서드

정의

오버로드

ToString(IFormatProvider)

매개 변수

반환

구현

예제

설명

추가 정보

적용 대상

ToString()

반환

예제

설명

추가 정보

적용 대상

ToString(String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

ToString(String, IFormatProvider)

매개 변수

반환

구현

예외

예제

설명

추가 정보

적용 대상

추가 리소스