Convert.ToString Convert.ToString Convert.ToString Convert.ToString Method

정의

지정된 값을 해당하는 문자열 표현으로 변환합니다.Converts the specified value to its equivalent string representation.

오버로드

ToString(Int16, Int32) ToString(Int16, Int32) ToString(Int16, Int32) ToString(Int16, Int32)

16비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.

ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 16비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 64비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 10진수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.

ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 DateTime의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified DateTime to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 32비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Double, IFormatProvider) ToString(Double, IFormatProvider) ToString(Double, IFormatProvider) ToString(Double, IFormatProvider)

지정된 배정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified double-precision floating-point number to its equivalent string representation.

ToString(Int32, Int32) ToString(Int32, Int32) ToString(Int32, Int32) ToString(Int32, Int32)

32비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.

ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 8비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Int64, Int32) ToString(Int64, Int32) ToString(Int64, Int32) ToString(Int64, Int32)

64비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.

ToString(Object, IFormatProvider) ToString(Object, IFormatProvider) ToString(Object, IFormatProvider) ToString(Object, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.

ToString(Single, IFormatProvider) ToString(Single, IFormatProvider) ToString(Single, IFormatProvider) ToString(Single, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 단정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

지정된 문자열 인스턴스를 실제 변환 작업 없이 반환합니다.Returns the specified string instance; no actual conversion is performed.

ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 16비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 32비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Char, IFormatProvider) ToString(Char, IFormatProvider) ToString(Char, IFormatProvider) ToString(Char, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 유니코드 문자의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 64비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Byte, Int32) ToString(Byte, Int32) ToString(Byte, Int32) ToString(Byte, Int32)

8비트 부호 없는 정수의 값을 특정 기수의 해당 문자열 표현으로 변환합니다.Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.

ToString(UInt64) ToString(UInt64) ToString(UInt64) ToString(UInt64)

지정된 64비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.

ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider)

지정된 부울 값을 해당하는 문자열 표현으로 변환합니다.Converts the specified Boolean value to its equivalent string representation.

ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 8비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

ToString(Boolean) ToString(Boolean) ToString(Boolean) ToString(Boolean)

지정된 부울 값을 해당하는 문자열 표현으로 변환합니다.Converts the specified Boolean value to its equivalent string representation.

ToString(Byte) ToString(Byte) ToString(Byte) ToString(Byte)

지정된 8비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation.

ToString(Char) ToString(Char) ToString(Char) ToString(Char)

지정된 유니코드 문자의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified Unicode character to its equivalent string representation.

ToString(Decimal) ToString(Decimal) ToString(Decimal) ToString(Decimal)

지정된 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified decimal number to its equivalent string representation.

ToString(Double) ToString(Double) ToString(Double) ToString(Double)

지정된 배정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified double-precision floating-point number to its equivalent string representation.

ToString(Int16) ToString(Int16) ToString(Int16) ToString(Int16)

지정된 16비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit signed integer to its equivalent string representation.

ToString(DateTime) ToString(DateTime) ToString(DateTime) ToString(DateTime)

지정된 DateTime의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified DateTime to its equivalent string representation.

ToString(Int64) ToString(Int64) ToString(Int64) ToString(Int64)

지정된 64비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit signed integer to its equivalent string representation.

ToString(Object) ToString(Object) ToString(Object) ToString(Object)

지정된 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified object to its equivalent string representation.

ToString(SByte) ToString(SByte) ToString(SByte) ToString(SByte)

지정된 8비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit signed integer to its equivalent string representation.

ToString(Single) ToString(Single) ToString(Single) ToString(Single)

지정된 단정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified single-precision floating-point number to its equivalent string representation.

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 문자열 인스턴스를 실제 변환 작업 없이 반환합니다.Returns the specified string instance; no actual conversion is performed.

ToString(UInt16) ToString(UInt16) ToString(UInt16) ToString(UInt16)

지정된 16비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation.

ToString(UInt32) ToString(UInt32) ToString(UInt32) ToString(UInt32)

지정된 32비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation.

ToString(Int32) ToString(Int32) ToString(Int32) ToString(Int32)

지정된 32비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit signed integer to its equivalent string representation.

ToString(Int16, Int32) ToString(Int16, Int32) ToString(Int16, Int32) ToString(Int16, Int32)

16비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.

public:
 static System::String ^ ToString(short value, int toBase);
public static string ToString (short value, int toBase);
static member ToString : int16 * int -> string
Public Shared Function ToString (value As Short, toBase As Integer) As String

매개 변수

value
Int16 Int16 Int16 Int16

변환할 16비트 부호 있는 정수입니다.The 16-bit signed integer to convert.

toBase
Int32 Int32 Int32 Int32

반환 값의 기수로서 2, 8, 10 또는 16이어야 합니다.The base of the return value, which must be 2, 8, 10, or 16.

반환

value 기수를 사용한 toBase의 문자열 표현입니다.The string representation of value in base toBase.

예외

toBase가 2, 8, 10 또는 16이 아닙니다.toBase is not 2, 8, 10, or 16.

예제

다음 예제에서는 16 비트 부호 있는 정수 배열에서 각 요소 해당는 이진, 8 진수, 10 진수 및 16 진수 문자열 표현으로 변환 합니다.The following example converts each element in an array of 16-bit signed integers to its equivalent binary, octal, decimal, and hexadecimal string representations.

int[] bases = { 2, 8, 10, 16};
short[] numbers = { Int16.MinValue, -13621, -18, 12, 19142, Int16.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (short number in numbers)
   {
      Console.WriteLine("   {0,-8}  -->  0x{1}", 
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//       Base 2 conversion:
//          -32768    -->  0x1000000000000000
//          -13621    -->  0x1100101011001011
//          -18       -->  0x1111111111101110
//          12        -->  0x1100
//          19142     -->  0x100101011000110
//          32767     -->  0x111111111111111
//       Base 8 conversion:
//          -32768    -->  0x100000
//          -13621    -->  0x145313
//          -18       -->  0x177756
//          12        -->  0x14
//          19142     -->  0x45306
//          32767     -->  0x77777
//       Base 10 conversion:
//          -32768    -->  0x-32768
//          -13621    -->  0x-13621
//          -18       -->  0x-18
//          12        -->  0x12
//          19142     -->  0x19142
//          32767     -->  0x32767
//       Base 16 conversion:
//          -32768    -->  0x8000
//          -13621    -->  0xcacb
//          -18       -->  0xffee
//          12        -->  0xc
//          19142     -->  0x4ac6
//          32767     -->  0x7fff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Short = { Int16.MinValue, -13621, -18, 12, 19142, _
                           Int16.MaxValue }

For Each base As Integer In bases
   Console.WriteLine("Base {0} conversion:", base)
   For Each number As Short In numbers
      Console.WriteLine("   {0,-8}  -->  0x{1}", _
                        number, Convert.ToString(number, base))
   Next
Next
' The example displays the following output:
'       Base 2 conversion:
'          -32768    -->  0x1000000000000000
'          -13621    -->  0x1100101011001011
'          -18       -->  0x1111111111101110
'          12        -->  0x1100
'          19142     -->  0x100101011000110
'          32767     -->  0x111111111111111
'       Base 8 conversion:
'          -32768    -->  0x100000
'          -13621    -->  0x145313
'          -18       -->  0x177756
'          12        -->  0x14
'          19142     -->  0x45306
'          32767     -->  0x77777
'       Base 10 conversion:
'          -32768    -->  0x-32768
'          -13621    -->  0x-13621
'          -18       -->  0x-18
'          12        -->  0x12
'          19142     -->  0x19142
'          32767     -->  0x32767
'       Base 16 conversion:
'          -32768    -->  0x8000
'          -13621    -->  0xcacb
'          -18       -->  0xffee
'          12        -->  0xc
'          19142     -->  0x4ac6
'          32767     -->  0x7fff
let bases = [2; 8; 10; 16]
let numbers = [ Int16.MinValue; -13621s; -18s; 12s; 19142s; Int16.MaxValue ]

for baseValue in bases do
    printfn "Base %i conversion:" baseValue
    for number in numbers do
        printfn "   % -8i  -->  0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
//     Base 2 conversion:
//        -32768    -->  0x1000000000000000
//        -13621    -->  0x1100101011001011
//        -18       -->  0x1111111111101110
//         12       -->  0x1100
//         19142    -->  0x100101011000110
//         32767    -->  0x111111111111111
//     Base 8 conversion:
//        -32768    -->  0x100000
//        -13621    -->  0x145313
//        -18       -->  0x177756
//         12       -->  0x14
//         19142    -->  0x45306
//         32767    -->  0x77777
//     Base 10 conversion:
//        -32768    -->  0x-32768
//        -13621    -->  0x-13621
//        -18       -->  0x-18
//         12       -->  0x12
//         19142    -->  0x19142
//         32767    -->  0x32767
//     Base 16 conversion:
//        -32768    -->  0x8000
//        -13621    -->  0xcacb
//        -18       -->  0xffee
//         12       -->  0xc
//         19142    -->  0x4ac6
//         32767    -->  0x7fff

설명

하는 경우 value 가 양수인 및 toBase 2, 8 또는 16 이면 반환된 된 문자열 부호 및 크기 표현을 사용 합니다.If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. 하는 경우 value 음수 및 toBase 2, 8 또는 16 이면 반환된 된 문자열 2의 보수 표현이 사용 합니다.If value is negative and toBase is 2, 8, or 16, the returned string uses two's complement representation. 이 높은 순서 바이트가 (15 비트)의 상위 비트가 부호 비트로 해석 되는 것을 의미 합니다.This means that the high-order bit of the high-order byte (bit 15) is interpreted as the sign bit. 경우는 ToString(Int16, Int32) 메서드를 호출 하는 나중에 다시 변환할 수 숫자는 문자열을 만들려면, 변환을 수행 하기 비슷한 숫자 표시는 해당 메서드를 호출 해야 합니다.If the ToString(Int16, Int32) method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. 이러한 메서드를 포함 Convert.ToInt16(String, Int32)Int16.Parse(String, NumberStyles)입니다.Such methods include Convert.ToInt16(String, Int32) and Int16.Parse(String, NumberStyles).

ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider) ToString(Int16, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 16비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(short value, IFormatProvider ^ provider);
public static string ToString (short value, IFormatProvider provider);
static member ToString : int16 * IFormatProvider -> string
Public Shared Function ToString (value As Short, provider As IFormatProvider) As String

매개 변수

value
Int16 Int16 Int16 Int16

변환할 16비트 부호 있는 정수입니다.The 16-bit signed integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(Int16, IFormatProvider) 16 비트 정수 배열에서 각 요소는 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(Int16, IFormatProvider) method to convert each element in an array of 16-bit integers to its equivalent string representation. 고정 문화권 뿐만 아니라 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

short[] numbers = { Int16.MinValue, Int16.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (short number in numbers)
   Console.WriteLine("{0,-8}  -->  {1,8}", 
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), 
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -32768    -->    ~32768
//       32767     -->     32767
Dim numbers() As Short = { Int16.MinValue, Int16.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

For Each number As Short In numbers
   Console.WriteLine("{0,-8}  -->  {1,8}", _
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                     Convert.ToString(number, nfi))
Next
' The example displays the following output:
'       -32768    -->    ~32768
'       32767     -->     32767

설명

이 구현은 Int16.ToString(IFormatProvider)합니다.This implementation is identical to Int16.ToString(IFormatProvider).

ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider) ToString(UInt64, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 64비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::UInt64 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider provider);
static member ToString : uint64 * IFormatProvider -> string
Public Shared Function ToString (value As ULong, provider As IFormatProvider) As String

매개 변수

value
UInt64 UInt64 UInt64 UInt64

변환할 64비트 부호 없는 정수입니다.The 64-bit unsigned integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(UInt64, IFormatProvider) 부호 없는 정수 (long) 값을 해당 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(UInt64, IFormatProvider) method to convert an unsigned long integer value to its equivalent string representation. 고정 문화권 및 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses both the invariant culture and the custom NumberFormatInfo object. 출력은 기본적으로 "G" 형식 지정자를 포함 되어 있지 않으므로 양수 값을 사용 하 여 양수 부호는 이러한 형식 지정 정보를 사용 하지 않으면 나타냅니다.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.

ulong number = UInt64.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-12}  -->  {1,12}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//    18446744073709551615  -->  18446744073709551615
Dim number As ULong = UInt64.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

Console.WriteLine("{0,-12}  -->  {1,12}", _
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                  Convert.ToString(number, nfi))
' The example displays the following output:
'    18446744073709551615  -->  18446744073709551615

설명

이 구현은 UInt64.ToString(IFormatProvider)합니다.This implementation is identical to UInt64.ToString(IFormatProvider).

ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider) ToString(Decimal, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 10진수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::Decimal value, IFormatProvider ^ provider);
public static string ToString (decimal value, IFormatProvider provider);
static member ToString : decimal * IFormatProvider -> string
Public Shared Function ToString (value As Decimal, provider As IFormatProvider) As String

매개 변수

value
Decimal Decimal Decimal Decimal

변환할 10진수입니다.The decimal number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 배열의 각 요소를 변환 Decimal 값을 네 개 문화권의 해당 문자열 표현입니다.The following example converts each element in an array of Decimal values to its equivalent string representation in four different cultures.

// Define an array of numbers to display.
decimal[] numbers = { 1734231911290.16m, -17394.32921m,
                      3193.23m, 98012368321.684m };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (decimal number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}   
// The example displays the following output:
//    1734231911290.16:
//       en-US:     1734231911290.16
//       fr-FR:     1734231911290,16
//       ja-JP:     1734231911290.16
//       ru-RU:     1734231911290,16
//    
//    -17394.32921:
//       en-US:         -17394.32921
//       fr-FR:         -17394,32921
//       ja-JP:         -17394.32921
//       ru-RU:         -17394,32921
//    
//    3193.23:
//       en-US:              3193.23
//       fr-FR:              3193,23
//       ja-JP:              3193.23
//       ru-RU:              3193,23
//    
//    98012368321.684:
//       en-US:      98012368321.684
//       fr-FR:      98012368321,684
//       ja-JP:      98012368321.684
//       ru-RU:      98012368321,684
' Define an array of numbers to display.
Dim numbers() As Decimal = { 1734231911290.16d, -17394.32921d, _
                             3193.23d, 98012368321.684d }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }

For Each number As Decimal In numbers
   Console.WriteLine("{0}:", Convert.ToString(number, _
                             System.Globalization.CultureInfo.InvariantCulture))
   For Each cultureName As String In cultureNames
      Dim culture As New System.Globalization.CultureInfo(cultureName)
      Console.WriteLine("   {0}: {1,20}", _
                        culture.Name, Convert.ToString(number, culture))
   Next
   Console.WriteLine()
Next   
' The example displays the following output:
'    1734231911290.16:
'       en-US:     1734231911290.16
'       fr-FR:     1734231911290,16
'       ja-JP:     1734231911290.16
'       ru-RU:     1734231911290,16
'    
'    -17394.32921:
'       en-US:         -17394.32921
'       fr-FR:         -17394,32921
'       ja-JP:         -17394.32921
'       ru-RU:         -17394,32921
'    
'    3193.23:
'       en-US:              3193.23
'       fr-FR:              3193,23
'       ja-JP:              3193.23
'       ru-RU:              3193,23
'    
'    98012368321.684:
'       en-US:      98012368321.684
'       fr-FR:      98012368321,684
'       ja-JP:      98012368321.684
'       ru-RU:      98012368321,684

설명

이 구현은 Decimal.ToString(IFormatProvider)합니다.This implementation is identical to Decimal.ToString(IFormatProvider).

ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider) ToString(DateTime, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 DateTime의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified DateTime to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(DateTime value, IFormatProvider ^ provider);
public static string ToString (DateTime value, IFormatProvider provider);
static member ToString : DateTime * IFormatProvider -> string
Public Shared Function ToString (value As DateTime, provider As IFormatProvider) As String

매개 변수

value
DateTime DateTime DateTime DateTime

변환할 날짜 및 시간 값입니다.The date and time value to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제는 DateTime 값 여덟 개의 서로 다른 문화권에 해당 문자열 표현입니다.The following example converts a DateTime value to its equivalent string representation in eight different cultures.

// Specify the date to be formatted using various cultures.
DateTime tDate = new DateTime(2010, 4, 15, 20, 30, 40, 333);
// Specify the cultures.
string[] cultureNames = { "en-US", "es-AR", "fr-FR", "hi-IN",
                          "ja-JP", "nl-NL", "ru-RU", "ur-PK" };

Console.WriteLine("Converting the date {0}: ", 
                  Convert.ToString(tDate, 
                          System.Globalization.CultureInfo.InvariantCulture));

foreach (string cultureName in cultureNames)
{
   System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
   string dateString = Convert.ToString(tDate, culture);
   Console.WriteLine("   {0}:  {1,-12}", 
                     culture.Name, dateString);
}             
// The example displays the following output:
//       Converting the date 04/15/2010 20:30:40:
//          en-US:  4/15/2010 8:30:40 PM
//          es-AR:  15/04/2010 08:30:40 p.m.
//          fr-FR:  15/04/2010 20:30:40
//          hi-IN:  15-04-2010 20:30:40
//          ja-JP:  2010/04/15 20:30:40
//          nl-NL:  15-4-2010 20:30:40
//          ru-RU:  15.04.2010 20:30:40
//          ur-PK:  15/04/2010 8:30:40 PM      
' Specify the date to be formatted using various cultures.
Dim tDate As New Date(2010, 4, 15, 20, 30, 40, 333)
' Specify the cultures.
Dim cultureNames() As String = { "en-US", "es-AR", "fr-FR", "hi-IN", _
                                 "ja-JP", "nl-NL", "ru-RU", "ur-PK" }

Console.WriteLine("Converting the date {0}: ", _
                  Convert.ToString(tDate, _
                          System.Globalization.CultureInfo.InvariantCulture))

For Each cultureName As String In CultureNames
   Dim culture As New System.Globalization.CultureInfo(cultureName)
   Dim dateString As String = Convert.ToString(tDate, culture)
   Console.WriteLine("   {0}:  {1,-12}", _
                     culture.Name, dateString)
Next             
' The example displays the following output:
'       Converting the date 04/15/2010 20:30:40:
'          en-US:  4/15/2010 8:30:40 PM
'          es-AR:  15/04/2010 08:30:40 p.m.
'          fr-FR:  15/04/2010 20:30:40
'          hi-IN:  15-04-2010 20:30:40
'          ja-JP:  2010/04/15 20:30:40
'          nl-NL:  15-4-2010 20:30:40
'          ru-RU:  15.04.2010 20:30:40
'          ur-PK:  15/04/2010 8:30:40 PM      

설명

이 구현은 DateTime.ToString(IFormatProvider)합니다.This implementation is identical to DateTime.ToString(IFormatProvider).

ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider) ToString(Int32, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 32비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(int value, IFormatProvider ^ provider);
public static string ToString (int value, IFormatProvider provider);
static member ToString : int * IFormatProvider -> string
Public Shared Function ToString (value As Integer, provider As IFormatProvider) As String

매개 변수

value
Int32 Int32 Int32 Int32

변환할 32비트 부호 있는 정수입니다.The 32-bit signed integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(Int32, IFormatProvider) 정수 배열의 각 요소는 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(Int32, IFormatProvider) method to convert each element in an array of integers to its equivalent string representation. 고정 문화권 뿐만 아니라 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

int[] numbers = { Int32.MinValue, Int32.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (int number in numbers)
   Console.WriteLine("{0,-12}  -->  {1,12}", 
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), 
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -2147483648  -->  ~2147483648
//       2147483647  -->  2147483647
Dim numbers() As Integer = { Int32.MinValue, Int32.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

For Each number As Integer In numbers
   Console.WriteLine("{0,-12}  -->  {1,12}", _
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                     Convert.ToString(number, nfi))
Next
' The example displays the following output:
'       -2147483648  -->  ~2147483648
'       2147483647   -->  2147483647

설명

이 구현은 Int32.ToString(IFormatProvider)합니다.This implementation is identical to Int32.ToString(IFormatProvider).

ToString(Double, IFormatProvider) ToString(Double, IFormatProvider) ToString(Double, IFormatProvider) ToString(Double, IFormatProvider)

지정된 배정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified double-precision floating-point number to its equivalent string representation.

public:
 static System::String ^ ToString(double value, IFormatProvider ^ provider);
public static string ToString (double value, IFormatProvider provider);
static member ToString : double * IFormatProvider -> string
Public Shared Function ToString (value As Double, provider As IFormatProvider) As String

매개 변수

value
Double Double Double Double

변환할 배정밀도 부동 소수점 숫자입니다.The double-precision floating-point number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 배열의 각 요소를 변환 Double 값을 네 개 문화권의 해당 문자열 표현입니다.The following example converts each element in an array of Double values to its equivalent string representation in four different cultures.

// Define an array of numbers to display.
double[] numbers = { -1.5345e16, -123.4321, 19092.123, 1.1734231911290e16 };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (double number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}   
// The example displays the following output:
//    -1.5345E+16:
//       en-US:          -1.5345E+16
//       fr-FR:          -1,5345E+16
//       ja-JP:          -1.5345E+16
//       ru-RU:          -1,5345E+16
//    
//    -123.4321:
//       en-US:            -123.4321
//       fr-FR:            -123,4321
//       ja-JP:            -123.4321
//       ru-RU:            -123,4321
//    
//    19092.123:
//       en-US:            19092.123
//       fr-FR:            19092,123
//       ja-JP:            19092.123
//       ru-RU:            19092,123
//    
//    1.173423191129E+16:
//       en-US:   1.173423191129E+16
//       fr-FR:   1,173423191129E+16
//       ja-JP:   1.173423191129E+16
//       ru-RU:   1,173423191129E+16
' Define an array of numbers to display.
Dim numbers() As Double = { -1.5345e16, -123.4321, 19092.123, _
                            1.1734231911290e16 }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }

For Each number As Double In numbers
   Console.WriteLine("{0}:", Convert.ToString(number, _
                             System.Globalization.CultureInfo.InvariantCulture))
   For Each cultureName As String In cultureNames
      Dim culture As New System.Globalization.CultureInfo(cultureName)
      Console.WriteLine("   {0}: {1,20}", _
                        culture.Name, Convert.ToString(number, culture))
   Next
   Console.WriteLine()
Next   
' The example displays the following output:
'    -1.5345E+16:
'       en-US:          -1.5345E+16
'       fr-FR:          -1,5345E+16
'       ja-JP:          -1.5345E+16
'       ru-RU:          -1,5345E+16
'    
'    -123.4321:
'       en-US:            -123.4321
'       fr-FR:            -123,4321
'       ja-JP:            -123.4321
'       ru-RU:            -123,4321
'    
'    19092.123:
'       en-US:            19092.123
'       fr-FR:            19092,123
'       ja-JP:            19092.123
'       ru-RU:            19092,123
'    
'    1.173423191129E+16:
'       en-US:   1.173423191129E+16
'       fr-FR:   1,173423191129E+16
'       ja-JP:   1.173423191129E+16
'       ru-RU:   1,173423191129E+16

설명

이 구현은 Double.ToString(IFormatProvider)This implementation is identical to Double.ToString(IFormatProvider)

ToString(Int32, Int32) ToString(Int32, Int32) ToString(Int32, Int32) ToString(Int32, Int32)

32비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.

public:
 static System::String ^ ToString(int value, int toBase);
public static string ToString (int value, int toBase);
static member ToString : int * int -> string
Public Shared Function ToString (value As Integer, toBase As Integer) As String

매개 변수

value
Int32 Int32 Int32 Int32

변환할 32비트 부호 있는 정수입니다.The 32-bit signed integer to convert.

toBase
Int32 Int32 Int32 Int32

반환 값의 기수로서 2, 8, 10 또는 16이어야 합니다.The base of the return value, which must be 2, 8, 10, or 16.

반환

value 기수를 사용한 toBase의 문자열 표현입니다.The string representation of value in base toBase.

예외

toBase가 2, 8, 10 또는 16이 아닙니다.toBase is not 2, 8, 10, or 16.

예제

다음 예제에서는 정수 배열의 각 요소 해당 하는 이진, 16 진수, 10 진수 및 16 진수 문자열 표현으로 변환 합니다.The following example converts each element in an integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.

int[] bases = { 2, 8, 10, 16};
int[] numbers = { Int32.MinValue, -19327543, -13621, -18, 12, 
                             19142, Int32.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (int number in numbers)
   {
      Console.WriteLine("   {0,-15}  -->  0x{1}", 
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//    Base 2 conversion:
//       -2147483648      -->  0x10000000000000000000000000000000
//       -19327543        -->  0x11111110110110010001010111001001
//       -13621           -->  0x11111111111111111100101011001011
//       -18              -->  0x11111111111111111111111111101110
//       12               -->  0x1100
//       19142            -->  0x100101011000110
//       2147483647       -->  0x1111111111111111111111111111111
//    Base 8 conversion:
//       -2147483648      -->  0x20000000000
//       -19327543        -->  0x37666212711
//       -13621           -->  0x37777745313
//       -18              -->  0x37777777756
//       12               -->  0x14
//       19142            -->  0x45306
//       2147483647       -->  0x17777777777
//    Base 10 conversion:
//       -2147483648      -->  0x-2147483648
//       -19327543        -->  0x-19327543
//       -13621           -->  0x-13621
//       -18              -->  0x-18
//       12               -->  0x12
//       19142            -->  0x19142
//       2147483647       -->  0x2147483647
//    Base 16 conversion:
//       -2147483648      -->  0x80000000
//       -19327543        -->  0xfed915c9
//       -13621           -->  0xffffcacb
//       -18              -->  0xffffffee
//       12               -->  0xc
//       19142            -->  0x4ac6
//       2147483647       -->  0x7fffffff       
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Integer = { Int32.MinValue, -19327543, -13621, -18, 12, _
                             19142, Int32.MaxValue }

For Each base As Integer In bases
   Console.WriteLine("Base {0} conversion:", base)
   For Each number As Integer In numbers
      Console.WriteLine("   {0,-15}  -->  0x{1}", _
                        number, Convert.ToString(number, base))
   Next
Next
' The example displays the following output:
'    Base 2 conversion:
'       -2147483648      -->  0x10000000000000000000000000000000
'       -19327543        -->  0x11111110110110010001010111001001
'       -13621           -->  0x11111111111111111100101011001011
'       -18              -->  0x11111111111111111111111111101110
'       12               -->  0x1100
'       19142            -->  0x100101011000110
'       2147483647       -->  0x1111111111111111111111111111111
'    Base 8 conversion:
'       -2147483648      -->  0x20000000000
'       -19327543        -->  0x37666212711
'       -13621           -->  0x37777745313
'       -18              -->  0x37777777756
'       12               -->  0x14
'       19142            -->  0x45306
'       2147483647       -->  0x17777777777
'    Base 10 conversion:
'       -2147483648      -->  0x-2147483648
'       -19327543        -->  0x-19327543
'       -13621           -->  0x-13621
'       -18              -->  0x-18
'       12               -->  0x12
'       19142            -->  0x19142
'       2147483647       -->  0x2147483647
'    Base 16 conversion:
'       -2147483648      -->  0x80000000
'       -19327543        -->  0xfed915c9
'       -13621           -->  0xffffcacb
'       -18              -->  0xffffffee
'       12               -->  0xc
'       19142            -->  0x4ac6
'       2147483647       -->  0x7fffffff
let bases = [2; 8; 10; 16]
let numbers = [ Int32.MinValue; -19327543; -13621; -18; 12; 19142; Int32.MaxValue ]

for baseValue in bases do
    printfn "Base %i conversion:" baseValue
    for number in numbers do
        printfn "   % -15i  -->  0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
//     Base 2 conversion:
//        -2147483648      -->  0x10000000000000000000000000000000
//        -19327543        -->  0x11111110110110010001010111001001
//        -13621           -->  0x11111111111111111100101011001011
//        -18              -->  0x11111111111111111111111111101110
//         12              -->  0x1100
//         19142           -->  0x100101011000110
//         2147483647      -->  0x1111111111111111111111111111111
//     Base 8 conversion:
//        -2147483648      -->  0x20000000000
//        -19327543        -->  0x37666212711
//        -13621           -->  0x37777745313
//        -18              -->  0x37777777756
//         12              -->  0x14
//         19142           -->  0x45306
//         2147483647      -->  0x17777777777
//     Base 10 conversion:
//        -2147483648      -->  0x-2147483648
//        -19327543        -->  0x-19327543
//        -13621           -->  0x-13621
//        -18              -->  0x-18
//         12              -->  0x12
//         19142           -->  0x19142
//         2147483647      -->  0x2147483647
//     Base 16 conversion:
//        -2147483648      -->  0x80000000
//        -19327543        -->  0xfed915c9
//        -13621           -->  0xffffcacb
//        -18              -->  0xffffffee
//         12              -->  0xc
//         19142           -->  0x4ac6
//         2147483647      -->  0x7fffffff

설명

하는 경우 value 가 양수인 및 toBase 2, 8 또는 16 이면 반환된 된 문자열 부호 및 크기 표현을 사용 합니다.If value is positive and toBase is 2, 8, or 16, the returned string uses sign-and-magnitude representation. 하는 경우 value 음수 및 toBase 2, 8 또는 16 이면 반환된 된 문자열 2의 보수 표현이 사용 합니다.If value is negative and toBase is 2, 8, or 16, the returned string uses two's complement representation. 이 최상위 바이트 (31 비트)의 상위 비트가 부호 비트로 해석 되는 것을 의미 합니다.This means that the high-order bit of the highest-order byte (bit 31) is interpreted as the sign bit. 경우는 ToString(Int32, Int32) 메서드를 호출 하는 나중에 다시 변환할 수 숫자는 문자열을 만들려면, 변환을 수행 하기 비슷한 숫자 표시는 해당 메서드를 호출 해야 합니다.If the ToString(Int32, Int32) method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. 이러한 메서드를 포함 Convert.ToInt32(String, Int32)Int32.Parse(String, NumberStyles)입니다.Such methods include Convert.ToInt32(String, Int32) and Int32.Parse(String, NumberStyles).

ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider) ToString(SByte, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 8비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::SByte value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider provider);
static member ToString : sbyte * IFormatProvider -> string
Public Shared Function ToString (value As SByte, provider As IFormatProvider) As String

매개 변수

value
SByte SByte SByte SByte

변환할 8비트 부호 있는 정수입니다.The 8-bit signed integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 Convert.ToString(SByte, IFormatProvider) 부호 있는 바이트 배열의 각 요소에에서 해당 하는 문자열 표현으로 변환 하는 방법입니다.It then calls the Convert.ToString(SByte, IFormatProvider) method to convert each element in signed byte array to its equivalent string representation. 고정 문화권 뿐만 아니라 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

sbyte[] numbers = { SByte.MinValue, -12, 17, SByte.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (sbyte number in numbers)
   Console.WriteLine(Convert.ToString(number, nfi));
// The example displays the following output:
//       ~128
//       ~12
//       17
//       127      
Dim numbers() As SByte = { SByte.MinValue, -12, 17, SByte.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"
For Each number As SByte In numbers
   Console.WriteLine(Convert.ToString(number, nfi))
Next
' The example displays the following output:
'       ~128
'       ~12
'       17
'       127          

설명

이 구현은 SByte.ToString(IFormatProvider)합니다.This implementation is identical to SByte.ToString(IFormatProvider).

ToString(Int64, Int32) ToString(Int64, Int32) ToString(Int64, Int32) ToString(Int64, Int32)

64비트 부호 있는 정수 값을 지정된 기수의 해당하는 문자열 표현으로 변환합니다.Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.

public:
 static System::String ^ ToString(long value, int toBase);
public static string ToString (long value, int toBase);
static member ToString : int64 * int -> string
Public Shared Function ToString (value As Long, toBase As Integer) As String

매개 변수

value
Int64 Int64 Int64 Int64

변환할 64비트 부호 있는 정수입니다.The 64-bit signed integer to convert.

toBase
Int32 Int32 Int32 Int32

반환 값의 기수로서 2, 8, 10 또는 16이어야 합니다.The base of the return value, which must be 2, 8, 10, or 16.

반환

value 기수를 사용한 toBase의 문자열 표현입니다.The string representation of value in base toBase.

예외

toBase가 2, 8, 10 또는 16이 아닙니다.toBase is not 2, 8, 10, or 16.

예제

다음 예제에서는 정수 (long) 배열의 각 요소에에서 해당는 이진, 16 진수, 10 진수 및 16 진수 문자열 표현으로 변환 합니다.The following example converts each element in a long integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.

int[] bases = { 2, 8, 10, 16};
long[] numbers = { Int64.MinValue, -193275430, -13621, -18, 12, 
                   1914206117, Int64.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (long number in numbers)
   {
      Console.WriteLine("   {0,-23}  -->  0x{1}", 
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//    Base 2 conversion:
//       -9223372036854775808     -->  0x1000000000000000000000000000000000000000000000000000000000000000
//       -193275430               -->  0x1111111111111111111111111111111111110100011110101101100111011010
//       -13621                   -->  0x1111111111111111111111111111111111111111111111111100101011001011
//       -18                      -->  0x1111111111111111111111111111111111111111111111111111111111101110
//       12                       -->  0x1100
//       1914206117               -->  0x1110010000110000111011110100101
//       9223372036854775807      -->  0x111111111111111111111111111111111111111111111111111111111111111
//    Base 8 conversion:
//       -9223372036854775808     -->  0x1000000000000000000000
//       -193275430               -->  0x1777777777776436554732
//       -13621                   -->  0x1777777777777777745313
//       -18                      -->  0x1777777777777777777756
//       12                       -->  0x14
//       1914206117               -->  0x16206073645
//       9223372036854775807      -->  0x777777777777777777777
//    Base 10 conversion:
//       -9223372036854775808     -->  0x-9223372036854775808
//       -193275430               -->  0x-193275430
//       -13621                   -->  0x-13621
//       -18                      -->  0x-18
//       12                       -->  0x12
//       1914206117               -->  0x1914206117
//       9223372036854775807      -->  0x9223372036854775807
//    Base 16 conversion:
//       -9223372036854775808     -->  0x8000000000000000
//       -193275430               -->  0xfffffffff47ad9da
//       -13621                   -->  0xffffffffffffcacb
//       -18                      -->  0xffffffffffffffee
//       12                       -->  0xc
//       1914206117               -->  0x721877a5
//       9223372036854775807      -->  0x7fffffffffffffff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Long = { Int64.MinValue, -193275430, -13621, -18, 12, _
                             1914206117, Int64.MaxValue }

For Each base As Integer In bases
   Console.WriteLine("Base {0} conversion:", base)
   For Each number As Long In numbers
      Console.WriteLine("   {0,-23}  -->  0x{1}", _
                        number, Convert.ToString(number, base))
   Next
Next
' The example displays the following output:
'    Base 2 conversion:
'       -9223372036854775808     -->  0x1000000000000000000000000000000000000000000000000000000000000000
'       -193275430               -->  0x1111111111111111111111111111111111110100011110101101100111011010
'       -13621                   -->  0x1111111111111111111111111111111111111111111111111100101011001011
'       -18                      -->  0x1111111111111111111111111111111111111111111111111111111111101110
'       12                       -->  0x1100
'       1914206117               -->  0x1110010000110000111011110100101
'       9223372036854775807      -->  0x111111111111111111111111111111111111111111111111111111111111111
'    Base 8 conversion:
'       -9223372036854775808     -->  0x1000000000000000000000
'       -193275430               -->  0x1777777777776436554732
'       -13621                   -->  0x1777777777777777745313
'       -18                      -->  0x1777777777777777777756
'       12                       -->  0x14
'       1914206117               -->  0x16206073645
'       9223372036854775807      -->  0x777777777777777777777
'    Base 10 conversion:
'       -9223372036854775808     -->  0x-9223372036854775808
'       -193275430               -->  0x-193275430
'       -13621                   -->  0x-13621
'       -18                      -->  0x-18
'       12                       -->  0x12
'       1914206117               -->  0x1914206117
'       9223372036854775807      -->  0x9223372036854775807
'    Base 16 conversion:
'       -9223372036854775808     -->  0x8000000000000000
'       -193275430               -->  0xfffffffff47ad9da
'       -13621                   -->  0xffffffffffffcacb
'       -18                      -->  0xffffffffffffffee
'       12                       -->  0xc
'       1914206117               -->  0x721877a5
'       9223372036854775807      -->  0x7fffffffffffffff
let bases = [2; 8; 10; 16]
let numbers = [ Int64.MinValue; -193275430L; -13621L; -18L; 12L; 1914206117L; Int64.MaxValue ]

for baseValue in bases do
    printfn "Base %i conversion:" baseValue
    for number in numbers do
        printfn "   % -23i  -->  0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
//     Base 2 conversion:
//        -9223372036854775808     -->  0x1000000000000000000000000000000000000000000000000000000000000000
//        -193275430               -->  0x1111111111111111111111111111111111110100011110101101100111011010
//        -13621                   -->  0x1111111111111111111111111111111111111111111111111100101011001011
//        -18                      -->  0x1111111111111111111111111111111111111111111111111111111111101110
//         12                      -->  0x1100
//         1914206117              -->  0x1110010000110000111011110100101
//         9223372036854775807     -->  0x111111111111111111111111111111111111111111111111111111111111111
//     Base 8 conversion:
//        -9223372036854775808     -->  0x1000000000000000000000
//        -193275430               -->  0x1777777777776436554732
//        -13621                   -->  0x1777777777777777745313
//        -18                      -->  0x1777777777777777777756
//         12                      -->  0x14
//         1914206117              -->  0x16206073645
//         9223372036854775807     -->  0x777777777777777777777
//     Base 10 conversion:
//        -9223372036854775808     -->  0x-9223372036854775808
//        -193275430               -->  0x-193275430
//        -13621                   -->  0x-13621
//        -18                      -->  0x-18
//         12                      -->  0x12
//         1914206117              -->  0x1914206117
//         9223372036854775807     -->  0x9223372036854775807
//     Base 16 conversion:
//        -9223372036854775808     -->  0x8000000000000000
//        -193275430               -->  0xfffffffff47ad9da
//        -13621                   -->  0xffffffffffffcacb
//        -18                      -->  0xffffffffffffffee
//         12                      -->  0xc
//         1914206117              -->  0x721877a5
//         9223372036854775807     -->  0x7fffffffffffffff

설명

하는 경우 value 가 양수인 및 toBase 가 10이 아니면 반환된 된 문자열 부호 및 크기 표현을 사용 합니다.If value is positive and toBase is not 10, the returned string uses sign-and-magnitude representation. 하는 경우 value 음수 및 toBase 가 10이 아니면 반환된 된 문자열 2의 보수 표현이 사용 합니다.If value is negative and toBase is not 10, the returned string uses two's complement representation. 이 최상위 바이트 (63 비트)의 상위 비트가 부호 비트로 해석 되는 것을 의미 합니다.This means that the high-order bit of the highest-order byte (bit 63) is interpreted as the sign bit. 경우는 ToString(Int64, Int32) 메서드를 호출 하는 나중에 다시 변환할 수 숫자는 문자열을 만들려면, 변환을 수행 하기 비슷한 숫자 표시는 해당 메서드를 호출 해야 합니다.If the ToString(Int64, Int32) method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. 이러한 메서드를 포함 Convert.ToInt64(String, Int32)Int64.Parse(String, NumberStyles)입니다.Such methods include Convert.ToInt64(String, Int32) and Int64.Parse(String, NumberStyles).

ToString(Object, IFormatProvider) ToString(Object, IFormatProvider) ToString(Object, IFormatProvider) ToString(Object, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::Object ^ value, IFormatProvider ^ provider);
public static string ToString (object value, IFormatProvider provider);
static member ToString : obj * IFormatProvider -> string
Public Shared Function ToString (value As Object, provider As IFormatProvider) As String

매개 변수

value
Object Object Object Object

변환할 값을 제공하는 개체나 null입니다.An object that supplies the value to convert, or null.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value가 값이 Empty인 개체인 경우 문자열 표시가 value 또는 null입니다.The string representation of value, or Empty if value is an object whose value is null. valuenull이면 메서드에서 null을 반환합니다.If value is null, the method returns null.

예제

다음 예제에서는 정의 Temperature 재정의 하는 클래스를 Object.ToString 메서드를 구현 하지 않습니다 하지만 IConvertible 인터페이스입니다.The following example defines a Temperature class that overrides the Object.ToString method but does not implement the IConvertible interface. 예제에 하는 방법에 대 한 호출을 Convert.ToString(Object, IFormatProvider) 메서드를 호출 하 고는 Temperature.ToString 메서드.The example illustrates how calls to the Convert.ToString(Object, IFormatProvider) method, in turn, call the Temperature.ToString method.

using System;

public class Temperature
{
   private decimal m_Temp;

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   }
   
   public decimal Celsius
   {
      get { return this.m_Temp; }   
   }
   
   public decimal Kelvin
   {
      get { return this.m_Temp + 273.15m; }    
   }
   
   public decimal Fahrenheit
   {
      get { return Math.Round((decimal) (this.m_Temp * 9 / 5 + 32), 2); }
   }
   
   public override string ToString()
   {
      return m_Temp.ToString("N2") + " °C";
   }

}

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature(-40);
      Temperature freezing = new Temperature(0);
      Temperature boiling = new Temperature(100);
      
      Console.WriteLine(Convert.ToString(cold, null));
      Console.WriteLine(Convert.ToString(freezing, null));
      Console.WriteLine(Convert.ToString(boiling, null));
   }
}
// The example dosplays the following output:
//       -40.00 °C
//       0.00 °C
//       100.00 °C
Public Class Temperature 
   Private m_Temp As Decimal

   Public Sub New(temperature As Decimal)
      Me.m_Temp = temperature
   End Sub
   
   Public ReadOnly Property Celsius() As Decimal
      Get
         Return Me.m_Temp
      End Get   
   End Property
   
   Public ReadOnly Property Kelvin() As Decimal
      Get
         Return Me.m_Temp + 273.15d   
      End Get
   End Property
   
   Public ReadOnly Property Fahrenheit() As Decimal
      Get
         Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
      End Get      
   End Property
   
   Public Overrides Function ToString() As String
      Return m_Temp.ToString("N2") & " °C"
   End Function
End Class

Module Example
   Public Sub Main()
      Dim cold As New Temperature(-40)
      Dim freezing As New Temperature(0)
      Dim boiling As New Temperature(100)
      
      Console.WriteLine(Convert.ToString(cold, Nothing))
      Console.WriteLine(Convert.ToString(freezing, Nothing))
      Console.WriteLine(Convert.ToString(boiling, Nothing))
   End Sub
End Module
' The example displays the following output:
'       -40.00 °C
'       0.00 °C
'       100.00 °C

다음 예제에서는 정의 Temperature 클래스를 구현 하는 IFormattable 인터페이스를 구현 하지 않습니다 하지만 IConvertible 인터페이스입니다.The following example defines a Temperature class that implements the IFormattable interface but does not implement the IConvertible interface. 해당 IFormattable.ToString 구현은 Temperature 형식 문자열에 따라 섭씨, 화씨 온도 켈빈의 값입니다.Its IFormattable.ToString implementation represents the Temperature value in Celsius, Fahrenheit, or Kelvin, depending on the format string. 예제도 정의 TemperatureProvider 클래스를 구현 하는 IFormatProvider 에서 사용 되는 임의로 생성 된 서식 문자열을 제공 하 고는 IFormattable 구현의 Temperature 클래스입니다.The example also defines a TemperatureProvider class that implements IFormatProvider and provides a randomly generated format string that is used by the IFormattable implementation of the Temperature class.

using System;

public class Temperature : IFormattable 
{
   private decimal m_Temp; 

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   } 

   public decimal Celsius 
   { get { return this.m_Temp; } } 

   public decimal Kelvin 
   { get { return this.m_Temp + 273.15m; } }   

   public decimal Fahrenheit
   {  get { return Math.Round(this.m_Temp * 9m / 5m + 32m, 2); } }

   public override String ToString() 
   { 
      return ToString("G", null); 
   } 
   
   public String ToString(String fmt, IFormatProvider provider) 
   {
      TemperatureProvider formatter = null;
      if (provider != null) 
         formatter = provider.GetFormat(typeof(TemperatureProvider)) 
                                       as TemperatureProvider;

      if (String.IsNullOrWhiteSpace(fmt)) {
         if (formatter != null) 
            fmt = formatter.Format;
         else
            fmt = "G";
      }

      switch (fmt.ToUpper()) {
         case "G":
         case "C":
            return m_Temp.ToString("N2") + " °C"; 
         case "F":
            return Fahrenheit.ToString("N2") + " °F";
         case "K":
            return Kelvin.ToString("N2") + " K";
         default:
            throw new FormatException(String.Format("'{0}' is not a valid format specifier.", fmt));
      }
   }                             
} 

public class TemperatureProvider : IFormatProvider
{
   private String[] fmtStrings = { "C", "G", "F", "K" };
   private Random rnd = new Random();
   
   public Object GetFormat(Type formatType) 
   { 
      return this; 
   }
   
   public String Format
   { get { return fmtStrings[rnd.Next(0, fmtStrings.Length)]; } }
}

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature (-40);
      Temperature freezing = new Temperature (0);
      Temperature boiling = new Temperature (100);

      TemperatureProvider tp = new TemperatureProvider();
      
      Console.WriteLine(Convert.ToString(cold, tp));
      Console.WriteLine(Convert.ToString(freezing, tp));
      Console.WriteLine(Convert.ToString(boiling, tp));
   }
}
// The example displays output like the following:
//       -40.00 °C
//       273.15 K
//       100.00 °C
Public Class Temperature : Implements IFormattable 
   Private m_Temp As Decimal 

   Public Sub New(temperature As Decimal)
      Me.m_Temp = temperature
   End Sub 

   Public ReadOnly Property Celsius As Decimal 
      Get 
         Return Me.m_Temp
      End Get    
   End Property 

   Public ReadOnly Property Kelvin As Decimal 
      Get 
         Return Me.m_Temp + 273.15d   
      End Get 
   End Property 

   Public ReadOnly Property Fahrenheit As Decimal 
      Get 
         Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
      End Get       
   End Property 

   Public Overrides Function ToString() As String 
      Return ToString("G", Nothing) 
   End Function 
   
   Public Overloads Function ToString(fmt As String, 
                                      provider As IFormatProvider) As String _
                             Implements IFormattable.ToString
      Dim formatter As TemperatureProvider = Nothing
      If provider IsNot Nothing Then formatter = TryCast(provider.GetFormat(GetType(TemperatureProvider)),
                                                         TemperatureProvider)

      If String.IsNullOrWhiteSpace(fmt) Then
         If formatter IsNot Nothing Then
            fmt = formatter.Format
         Else
            fmt = "G"
         End If
      End If

      Select Case fmt.ToUpper()
         Case "G", "C"
            Return m_Temp.ToString("N2") & " °C" 
         Case "F"
            Return Fahrenheit.ToString("N2") + " °F"
         Case "K"
            Return Kelvin.ToString("N2") + " K"
         Case Else
            Throw New FormatException(String.Format("'{0}' is not a valid format specifier.", fmt))
      End Select
   End Function                             
End Class 

Public Class TemperatureProvider : Implements IFormatProvider
   Private fmtStrings() As String = { "C", "G", "F", "K" }
   Private rnd As New Random()
   
   Public Function GetFormat(formatType As Type) As Object _
                   Implements IFormatProvider.GetFormat 
      Return Me 
   End Function
   
   Public ReadOnly Property Format As String
      Get
         Return fmtStrings(rnd.Next(0, fmtStrings.Length))
      End Get
   End Property
End Class

Module Example
   Public Sub Main()
      Dim cold As New Temperature(-40)
      Dim freezing As New Temperature(0)
      Dim boiling As New Temperature(100)

      Dim tp As New TemperatureProvider()
      
      Console.WriteLine(Convert.ToString(cold, tp))
      Console.WriteLine(Convert.ToString(freezing, tp))
      Console.WriteLine(Convert.ToString(boiling, tp))
   End Sub 
End Module 
' The example displays output like the following:
'       -40.00 °C
'       273.15 K
'       100.00 °C

설명

경우는 value 매개 변수를 구현 하는 IConvertible 인터페이스, 메서드 호출을 IConvertible.ToString(IFormatProvider) 구현의 value합니다.If the value parameter implements the IConvertible interface, the method calls the IConvertible.ToString(IFormatProvider) implementation of value. 그렇지 않은 경우를 value 매개 변수를 구현 하는 IFormattable 인터페이스를 메서드 호출을 해당 IFormattable.ToString(String, IFormatProvider) 구현 합니다.Otherwise, if the value parameter implements the IFormattable interface, the method calls its IFormattable.ToString(String, IFormatProvider) implementation. 하는 경우 value 메서드 호출을 모두 인터페이스를 구현 합니다 value 매개 변수의 ToString() 메서드를 및 provider 매개 변수가 무시 됩니다.If value implements neither interface, the method calls the value parameter's ToString() method, and the provider parameter is ignored.

provider 경우 매개 변수를 사용 합니다 value 매개 변수를 구현 하는 IConvertible 또는 IFormattable 인터페이스입니다.The provider parameter is used if the value parameter implements the IConvertible or IFormattable interface. 가장 일반적으로 사용 합니다 provider 변환에 사용 되는 문화권별 정보를 지정 하려면 매개 변수는 value합니다.The most common use of the provider parameter is to specify culture-specific information used in the conversion of value. 예를 들어 경우는 value 매개 변수는 음수 10 진수 값이는 provider 매개 변수는 음수 부호와 소수 구분 기호에 사용 되는 표기법에 대 한 문화권별 형식 정보를 제공 합니다.For example, if the value parameter is a negative decimal number, the provider parameter can supply culture-specific information about the notation used for the negative sign and decimal separator. 다음 섹션에서 두 번째 예제에서는 문화권 구분 서식 지정 정보를 제공 하지 않는 하는 형식 공급자를 보여 줍니다.The second example in the next section illustrates a format provider that does not supply culture-sensitive formatting information.

ToString(Single, IFormatProvider) ToString(Single, IFormatProvider) ToString(Single, IFormatProvider) ToString(Single, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 단정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(float value, IFormatProvider ^ provider);
public static string ToString (float value, IFormatProvider provider);
static member ToString : single * IFormatProvider -> string
Public Shared Function ToString (value As Single, provider As IFormatProvider) As String

매개 변수

value
Single Single Single Single

변환할 단정밀도 부동 소수점 숫자입니다.The single-precision floating-point number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 배열의 각 요소를 변환 Single 값을 네 개 문화권의 해당 문자열 표현입니다.The following example converts each element in an array of Single values to its equivalent string representation in four different cultures.

// Define an array of numbers to display.
float[] numbers = { -1.5345e16f, -123.4321f, 19092.123f, 1.1734231911290e16f };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (float number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}   
// The example displays the following output:
//    -1.5345E+16:
//       en-US:          -1.5345E+16
//       fr-FR:          -1,5345E+16
//       ja-JP:          -1.5345E+16
//       ru-RU:          -1,5345E+16
//    
//    -123.4321:
//       en-US:            -123.4321
//       fr-FR:            -123,4321
//       ja-JP:            -123.4321
//       ru-RU:            -123,4321
//    
//    19092.123:
//       en-US:            19092.123
//       fr-FR:            19092,123
//       ja-JP:            19092.123
//       ru-RU:            19092,123
//    
//    1.173423191129E+16:
//       en-US:   1.173423191129E+16
//       fr-FR:   1,173423191129E+16
//       ja-JP:   1.173423191129E+16
//       ru-RU:   1,173423191129E+16
' Define an array of numbers to display.
Dim numbers() As Single = { -1.5345e16, -123.4321, 19092.123, _
                            1.1734231911290e16 }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR", "ja-JP", "ru-RU" }

For Each number As Single In numbers
   Console.WriteLine("{0}:", Convert.ToString(number, _
                             System.Globalization.CultureInfo.InvariantCulture))
   For Each cultureName As String In cultureNames
      Dim culture As New System.Globalization.CultureInfo(cultureName)
      Console.WriteLine("   {0}: {1,20}", _
                        culture.Name, Convert.ToString(number, culture))
   Next
   Console.WriteLine()
Next   
' The example displays the following output:
'    -1.5345E+16:
'       en-US:          -1.5345E+16
'       fr-FR:          -1,5345E+16
'       ja-JP:          -1.5345E+16
'       ru-RU:          -1,5345E+16
'    
'    -123.4321:
'       en-US:            -123.4321
'       fr-FR:            -123,4321
'       ja-JP:            -123.4321
'       ru-RU:            -123,4321
'    
'    19092.123:
'       en-US:            19092.123
'       fr-FR:            19092,123
'       ja-JP:            19092.123
'       ru-RU:            19092,123
'    
'    1.173423191129E+16:
'       en-US:   1.173423191129E+16
'       fr-FR:   1,173423191129E+16
'       ja-JP:   1.173423191129E+16
'       ru-RU:   1,173423191129E+16

설명

이 구현은 Single.ToString(IFormatProvider)합니다.This implementation is identical to Single.ToString(IFormatProvider).

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

지정된 문자열 인스턴스를 실제 변환 작업 없이 반환합니다.Returns the specified string instance; no actual conversion is performed.

public:
 static System::String ^ ToString(System::String ^ value, IFormatProvider ^ provider);
public static string ToString (string value, IFormatProvider provider);
static member ToString : string * IFormatProvider -> string
Public Shared Function ToString (value As String, provider As IFormatProvider) As String

매개 변수

value
String String String String

반환할 문자열입니다.The string to return.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information. 이 매개 변수는 무시됩니다.This parameter is ignored.

반환

value를 변경하지 않고 반환합니다.value is returned unchanged.

예제

다음 예제에서는 합니다 ToString 메서드는 String 매개 변수입니다.The following example calls the ToString method with a String parameter. 메서드는 수정 되지 않은 반환 String 를 참조 하지 않고는 IFormatProvider 개체입니다.The method returns the unmodified String without referencing the IFormatProvider object.

// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;

#define null (Object^)0

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:

   // Normally, GetFormat returns an object of the requested type
   // (usually itself) if it is able; otherwise, it returns Nothing. 
   virtual Object^ GetFormat( Type^ argType )
   {
      // Here, the type of argType is displayed, and GetFormat
      // always returns Nothing.
      Console::Write( "{0,-40}", argType->ToString() );
      return null;
   }
};

int main()
{
   // Create an instance of the IFormatProvider.
   DummyProvider^ provider = gcnew DummyProvider;
   String^ converted;

   // Convert these values using DummyProvider.
   int Int32A = -252645135;
   double DoubleA = 61680.3855;
   Object^ ObjDouble =  -98765.4321;
   DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
   bool BoolA = true;
   String^ StringA = "Qwerty";
   Char CharA = '$';
   TimeSpan TSpanA = TimeSpan(0,18,0);
   Object^ ObjOther = static_cast<Object^>(provider);
   Console::WriteLine( "This example of "
   "Convert::ToString( non-numeric, IFormatProvider* ) \n"
   "generates the following output. The provider type, "
   "argument type, \nand argument value are displayed." );
   Console::WriteLine( "\nNote: The IFormatProvider object is "
   "not called for Boolean, String, \nChar, TimeSpan, "
   "and non-numeric Object." );

   // The format provider is called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( Int32A, provider );
   Console::WriteLine( "int      {0}", converted );
   converted = Convert::ToString( DoubleA, provider );
   Console::WriteLine( "double   {0}", converted );
   converted = Convert::ToString( ObjDouble, provider );
   Console::WriteLine( "Object   {0}", converted );
   converted = Convert::ToString( DayTimeA, provider );
   Console::WriteLine( "DateTime {0}", converted );

   // The format provider is not called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( BoolA, provider );
   Console::WriteLine( "bool     {0}", converted );
   converted = Convert::ToString( StringA, provider );
   Console::WriteLine( "String   {0}", converted );
   converted = Convert::ToString( CharA, provider );
   Console::WriteLine( "Char     {0}", converted );
   converted = Convert::ToString( TSpanA, provider );
   Console::WriteLine( "TimeSpan {0}", converted );
   converted = Convert::ToString( ObjOther, provider );
   Console::WriteLine( "Object   {0}", converted );
}

/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   Object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
String   Qwerty
Char     $
TimeSpan 00:18:00
Object   DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing. 
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/ 
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization

' An instance of this class can be passed to methods that require 
' an IFormatProvider.
Public Class DummyProvider
    Implements IFormatProvider

    ' Normally, GetFormat returns an object of the requested type
    ' (usually itself) if it is able; otherwise, it returns Nothing. 
    Public Function GetFormat( argType As Type ) As Object _
        Implements IFormatProvider.GetFormat

        ' Here, the type of argType is displayed, and GetFormat
        ' always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) )
        Return Nothing

    End Function 
End Class

Module ConvertNonNumericProviderDemo

    Sub Main( )

        ' Create an instance of the IFormatProvider.
        Dim provider    As New DummyProvider( )
        Dim converted   As String

        ' Convert these values using DummyProvider.
        Dim Int32A      As Integer  = -252645135   
        Dim DoubleA     As Double   = 61680.3855
        Dim ObjDouble   As Object   = CType( -98765.4321, Object )
        Dim DayTimeA    As DateTime = _
                            new DateTime( 2001, 9, 11, 13, 45, 0 )

        Dim BoolA       As Boolean  = True
        Dim StringA     As String   = "Qwerty"
        Dim CharA       As Char     = "$"c
        Dim TSpanA      As TimeSpan = New TimeSpan( 0, 18, 0 )
        Dim ObjOther    As Object   = CType( provider, Object )

        Console.WriteLine( "This example of " & _
            "Convert.ToString( non-numeric, IFormatProvider ) " & _
            vbCrLf & "generates the following output. The " & _
            "provider type, argument type, " & vbCrLf & "and " & _
            "argument value are displayed." )
        Console.WriteLine( vbCrLf & _
            "Note: The IFormatProvider object is not called for " & _
            "Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
            "and non-numeric Object." )

        ' The format provider is called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( Int32A, provider )
        Console.WriteLine( "Int32    {0}", converted )
        converted =  Convert.ToString( DoubleA, provider )
        Console.WriteLine( "Double   {0}", converted )
        converted =  Convert.ToString( ObjDouble, provider )
        Console.WriteLine( "Object   {0}", converted )
        converted =  Convert.ToString( DayTimeA, provider )
        Console.WriteLine( "DateTime {0}", converted )

        ' The format provider is not called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( BoolA, provider )
        Console.WriteLine( "Boolean  {0}", converted )
        converted =  Convert.ToString( StringA, provider )
        Console.WriteLine( "String   {0}", converted )
        converted =  Convert.ToString( CharA, provider )
        Console.WriteLine( "Char     {0}", converted )
        converted =  Convert.ToString( TSpanA, provider )
        Console.WriteLine( "TimeSpan {0}", converted )
        converted =  Convert.ToString( ObjOther, provider )
        Console.WriteLine( "Object   {0}", converted )

    End Sub
End Module

' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
' 
' System.Globalization.NumberFormatInfo   Int32    -252645135
' System.Globalization.NumberFormatInfo   Double   61680.3855
' System.Globalization.NumberFormatInfo   Object   -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
' 
' Boolean  True
' String   Qwerty
' Char     $
' TimeSpan 00:18:00
' Object   DummyProvider

ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider) ToString(UInt16, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 16비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::UInt16 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider provider);
static member ToString : uint16 * IFormatProvider -> string
Public Shared Function ToString (value As UShort, provider As IFormatProvider) As String

매개 변수

value
UInt16 UInt16 UInt16 UInt16

변환할 16비트 부호 없는 정수입니다.The 16-bit unsigned integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(UInt16, IFormatProvider) 16 비트 부호 없는 정수 값을 해당 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(UInt16, IFormatProvider) method to convert a 16-bit unsigned integer value to its equivalent string representation. 고정 문화권 및 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses both the invariant culture and the custom NumberFormatInfo object. 출력은 기본적으로 "G" 형식 지정자를 포함 되어 있지 않으므로 양수 값을 사용 하 여 양수 부호는 이러한 형식 지정 정보를 사용 하지 않으면 나타냅니다.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.

ushort number = UInt16.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-6}  -->  {1,6}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//       65535   -->   65535
Dim number As UShort = UInt16.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

Console.WriteLine("{0,-6}  -->  {1,6}", _
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                  Convert.ToString(number, nfi))
' The example displays the following output:
'       65535   -->   65535

설명

이 구현은 UInt16.ToString(IFormatProvider)합니다.This implementation is identical to UInt16.ToString(IFormatProvider).

ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider) ToString(UInt32, IFormatProvider)

중요

이 API는 CLS 규격이 아닙니다.

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 32비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::UInt32 value, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider provider);
static member ToString : uint32 * IFormatProvider -> string
Public Shared Function ToString (value As UInteger, provider As IFormatProvider) As String

매개 변수

value
UInt32 UInt32 UInt32 UInt32

변환할 32비트 부호 없는 정수입니다.The 32-bit unsigned integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(UInt32, IFormatProvider) 부호 없는 정수 값을 해당 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(UInt32, IFormatProvider) method to convert an unsigned integer value to its equivalent string representation. 고정 문화권 및 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses both the invariant culture and the custom NumberFormatInfo object. 출력은 기본적으로 "G" 형식 지정자를 포함 되어 있지 않으므로 양수 값을 사용 하 여 양수 부호는 이러한 형식 지정 정보를 사용 하지 않으면 나타냅니다.The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.

uint number = UInt32.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-8}  -->  {1,8}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//       4294967295  -->  4294967295
Dim number As UInteger = UInt32.MaxValue
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

Console.WriteLine("{0,-8}  -->  {1,8}", _
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                  Convert.ToString(number, nfi))
' The example displays the following output:
'       4294967295  -->  4294967295

설명

이 구현은 UInt32.ToString(IFormatProvider)합니다.This implementation is identical to UInt32.ToString(IFormatProvider).

ToString(Char, IFormatProvider) ToString(Char, IFormatProvider) ToString(Char, IFormatProvider) ToString(Char, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 유니코드 문자의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(char value, IFormatProvider ^ provider);
public static string ToString (char value, IFormatProvider provider);
static member ToString : char * IFormatProvider -> string
Public Shared Function ToString (value As Char, provider As IFormatProvider) As String

매개 변수

value
Char Char Char Char

변환할 유니코드 문자입니다.The Unicode character to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information. 이 매개 변수는 무시됩니다.This parameter is ignored.

반환

value의 문자열 표현입니다.The string representation of value.

예제

변환 하는 다음 예제는 Char 값을 String 사용 하 여를 ToString 메서드를 사용 하 여는 IFormatProvider 호출 하는 형식 공급자의 유형을 표시 하는 개체입니다.The following example converts a Char value to a String with the ToString method, using an IFormatProvider object that displays the type of the format provider for which it is called. 예제에 따르면는 IFormatProvider 개체 참조 되지 않은 합니다.The example shows that the IFormatProvider object is not referenced.

// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;

#define null (Object^)0

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:

   // Normally, GetFormat returns an object of the requested type
   // (usually itself) if it is able; otherwise, it returns Nothing. 
   virtual Object^ GetFormat( Type^ argType )
   {
      // Here, the type of argType is displayed, and GetFormat
      // always returns Nothing.
      Console::Write( "{0,-40}", argType->ToString() );
      return null;
   }
};

int main()
{
   // Create an instance of the IFormatProvider.
   DummyProvider^ provider = gcnew DummyProvider;
   String^ converted;

   // Convert these values using DummyProvider.
   int Int32A = -252645135;
   double DoubleA = 61680.3855;
   Object^ ObjDouble =  -98765.4321;
   DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
   bool BoolA = true;
   String^ StringA = "Qwerty";
   Char CharA = '$';
   TimeSpan TSpanA = TimeSpan(0,18,0);
   Object^ ObjOther = static_cast<Object^>(provider);
   Console::WriteLine( "This example of "
   "Convert::ToString( non-numeric, IFormatProvider* ) \n"
   "generates the following output. The provider type, "
   "argument type, \nand argument value are displayed." );
   Console::WriteLine( "\nNote: The IFormatProvider object is "
   "not called for Boolean, String, \nChar, TimeSpan, "
   "and non-numeric Object." );

   // The format provider is called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( Int32A, provider );
   Console::WriteLine( "int      {0}", converted );
   converted = Convert::ToString( DoubleA, provider );
   Console::WriteLine( "double   {0}", converted );
   converted = Convert::ToString( ObjDouble, provider );
   Console::WriteLine( "Object   {0}", converted );
   converted = Convert::ToString( DayTimeA, provider );
   Console::WriteLine( "DateTime {0}", converted );

   // The format provider is not called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( BoolA, provider );
   Console::WriteLine( "bool     {0}", converted );
   converted = Convert::ToString( StringA, provider );
   Console::WriteLine( "String   {0}", converted );
   converted = Convert::ToString( CharA, provider );
   Console::WriteLine( "Char     {0}", converted );
   converted = Convert::ToString( TSpanA, provider );
   Console::WriteLine( "TimeSpan {0}", converted );
   converted = Convert::ToString( ObjOther, provider );
   Console::WriteLine( "Object   {0}", converted );
}

/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   Object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
String   Qwerty
Char     $
TimeSpan 00:18:00
Object   DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing. 
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/ 
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization

' An instance of this class can be passed to methods that require 
' an IFormatProvider.
Public Class DummyProvider
    Implements IFormatProvider

    ' Normally, GetFormat returns an object of the requested type
    ' (usually itself) if it is able; otherwise, it returns Nothing. 
    Public Function GetFormat( argType As Type ) As Object _
        Implements IFormatProvider.GetFormat

        ' Here, the type of argType is displayed, and GetFormat
        ' always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) )
        Return Nothing

    End Function 
End Class

Module ConvertNonNumericProviderDemo

    Sub Main( )

        ' Create an instance of the IFormatProvider.
        Dim provider    As New DummyProvider( )
        Dim converted   As String

        ' Convert these values using DummyProvider.
        Dim Int32A      As Integer  = -252645135   
        Dim DoubleA     As Double   = 61680.3855
        Dim ObjDouble   As Object   = CType( -98765.4321, Object )
        Dim DayTimeA    As DateTime = _
                            new DateTime( 2001, 9, 11, 13, 45, 0 )

        Dim BoolA       As Boolean  = True
        Dim StringA     As String   = "Qwerty"
        Dim CharA       As Char     = "$"c
        Dim TSpanA      As TimeSpan = New TimeSpan( 0, 18, 0 )
        Dim ObjOther    As Object   = CType( provider, Object )

        Console.WriteLine( "This example of " & _
            "Convert.ToString( non-numeric, IFormatProvider ) " & _
            vbCrLf & "generates the following output. The " & _
            "provider type, argument type, " & vbCrLf & "and " & _
            "argument value are displayed." )
        Console.WriteLine( vbCrLf & _
            "Note: The IFormatProvider object is not called for " & _
            "Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
            "and non-numeric Object." )

        ' The format provider is called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( Int32A, provider )
        Console.WriteLine( "Int32    {0}", converted )
        converted =  Convert.ToString( DoubleA, provider )
        Console.WriteLine( "Double   {0}", converted )
        converted =  Convert.ToString( ObjDouble, provider )
        Console.WriteLine( "Object   {0}", converted )
        converted =  Convert.ToString( DayTimeA, provider )
        Console.WriteLine( "DateTime {0}", converted )

        ' The format provider is not called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( BoolA, provider )
        Console.WriteLine( "Boolean  {0}", converted )
        converted =  Convert.ToString( StringA, provider )
        Console.WriteLine( "String   {0}", converted )
        converted =  Convert.ToString( CharA, provider )
        Console.WriteLine( "Char     {0}", converted )
        converted =  Convert.ToString( TSpanA, provider )
        Console.WriteLine( "TimeSpan {0}", converted )
        converted =  Convert.ToString( ObjOther, provider )
        Console.WriteLine( "Object   {0}", converted )

    End Sub
End Module

' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
' 
' System.Globalization.NumberFormatInfo   Int32    -252645135
' System.Globalization.NumberFormatInfo   Double   61680.3855
' System.Globalization.NumberFormatInfo   Object   -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
' 
' Boolean  True
' String   Qwerty
' Char     $
' TimeSpan 00:18:00
' Object   DummyProvider

설명

이 구현은 Char.ToString()합니다.This implementation is identical to Char.ToString(). provider 매개 변수가 무시 됩니다.The provider parameter is ignored.

ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider) ToString(Int64, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 64비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(long value, IFormatProvider ^ provider);
public static string ToString (long value, IFormatProvider provider);
static member ToString : int64 * IFormatProvider -> string
Public Shared Function ToString (value As Long, provider As IFormatProvider) As String

매개 변수

value
Int64 Int64 Int64 Int64

변환할 64비트 부호 있는 정수입니다.The 64-bit signed integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 사용자 지정 정의 NumberFormatInfo 문자열로 해당 음수 기호를 정의 하는 클래스 "~"및 해당 양수 부호 문자열"!".The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". 그런 다음 호출 하 여 ToString(Int64, IFormatProvider) 정수 (long) 배열의 각 요소에에서 해당 하는 문자열 표현으로 변환 하는 방법입니다.It then calls the ToString(Int64, IFormatProvider) method to convert each element in a long integer array to its equivalent string representation. 고정 문화권 뿐만 아니라 사용자 지정 변환을 사용 하 여 NumberFormatInfo 개체입니다.The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

long[] numbers = { ((long) Int32.MinValue) * 2, ((long) Int32.MaxValue) * 2};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (long number in numbers)
   Console.WriteLine("{0,-12}  -->  {1,12}", 
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), 
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -4294967296  -->  ~4294967296
//       4294967294  -->  4294967294
Dim numbers() As Long = { CLng(Int32.MinValue) * 2, CLng(Int32.MaxValue) * 2 }
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

For Each number As Long In numbers
   Console.WriteLine("{0,-12}  -->  {1,12}", _
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                     Convert.ToString(number, nfi))
Next
' The example displays the following output:
'       -4294967296  -->  ~4294967296
'       4294967294   -->  4294967294

설명

이 구현은 Int64.ToString(IFormatProvider)합니다.This implementation is identical to Int64.ToString(IFormatProvider).

ToString(Byte, Int32) ToString(Byte, Int32) ToString(Byte, Int32) ToString(Byte, Int32)

8비트 부호 없는 정수의 값을 특정 기수의 해당 문자열 표현으로 변환합니다.Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.

public:
 static System::String ^ ToString(System::Byte value, int toBase);
public static string ToString (byte value, int toBase);
static member ToString : byte * int -> string
Public Shared Function ToString (value As Byte, toBase As Integer) As String

매개 변수

value
Byte Byte Byte Byte

변환할 8비트 부호 없는 정수입니다.The 8-bit unsigned integer to convert.

toBase
Int32 Int32 Int32 Int32

반환 값의 기수로서 2, 8, 10 또는 16이어야 합니다.The base of the return value, which must be 2, 8, 10, or 16.

반환

value 기수를 사용한 toBase의 문자열 표현입니다.The string representation of value in base toBase.

예외

toBase가 2, 8, 10 또는 16이 아닙니다.toBase is not 2, 8, 10, or 16.

예제

다음 예제에서는 바이트 배열의 각 요소에에서 해당 하는 이진, 16 진수, 10 진수 및 16 진수 문자열 표현으로 변환.The following example converts each element in a byte array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.

int[] bases = { 2, 8, 10, 16};
byte[] numbers = { Byte.MinValue, 12, 103, Byte.MaxValue};

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (byte number in numbers)
   {
      Console.WriteLine("   {0,-5}  -->  0x{1}", 
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//       Base 2 conversion:
//          0      -->  0x0
//          12     -->  0x1100
//          103    -->  0x1100111
//          255    -->  0x11111111
//       Base 8 conversion:
//          0      -->  0x0
//          12     -->  0x14
//          103    -->  0x147
//          255    -->  0x377
//       Base 10 conversion:
//          0      -->  0x0
//          12     -->  0x12
//          103    -->  0x103
//          255    -->  0x255
//       Base 16 conversion:
//          0      -->  0x0
//          12     -->  0xc
//          103    -->  0x67
//          255    -->  0xff
Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Byte = { Byte.MinValue, 12, 103, Byte.MaxValue}

For Each base As Integer In bases
   Console.WriteLine("Base {0} conversion:", base)
   For Each number As Byte In numbers
      Console.WriteLine("   {0,-5}  -->  0x{1}", _
                        number, Convert.ToString(number, base))
   Next
Next
' The example displays the following output:
'       Base 2 conversion:
'          0      -->  0x0
'          12     -->  0x1100
'          103    -->  0x1100111
'          255    -->  0x11111111
'       Base 8 conversion:
'          0      -->  0x0
'          12     -->  0x14
'          103    -->  0x147
'          255    -->  0x377
'       Base 10 conversion:
'          0      -->  0x0
'          12     -->  0x12
'          103    -->  0x103
'          255    -->  0x255
'       Base 16 conversion:
'          0      -->  0x0
'          12     -->  0xc
'          103    -->  0x67
'          255    -->  0xff
let bases = [2; 8; 10; 16]
let numbers = [ Byte.MinValue; 12uy; 103uy; Byte.MaxValue ]

for baseValue in bases do
    printfn "Base %i conversion:" baseValue
    for number in numbers do
        printfn "   % -5i  -->  0x%s" number (Convert.ToString (number, baseValue))
// The example displays the following output:
//     Base 2 conversion:
//         0     -->  0x0
//         12    -->  0x1100
//         103   -->  0x1100111
//         255   -->  0x11111111
//     Base 8 conversion:
//         0     -->  0x0
//         12    -->  0x14
//         103   -->  0x147
//         255   -->  0x377
//     Base 10 conversion:
//         0     -->  0x0
//         12    -->  0x12
//         103   -->  0x103
//         255   -->  0x255
//     Base 16 conversion:
//         0     -->  0x0
//         12    -->  0xc
//         103   -->  0x67
//         255   -->  0xff

설명

하는 경우 toBase 10에서 반환 되는 문자열이 같지 합니다 Convert.ToString(Byte, Int32) 메서드를 나타냅니다 value 은 크기에 합니다.If toBase does not equal 10, the string that is returned by the Convert.ToString(Byte, Int32) method represents value by its magnitude only. 수 다시 나중에 변환할 문자열을 만들려면 메서드를 호출 하면 변환을 수행 하기 크기만 숫자 표시는 해당 메서드가 호출 되어야 합니다.If the method is called to create a string that will later be converted back to a number, a corresponding method that assumes a magnitude-only numeric representation should be called to perform the conversion. 이러한 메서드를 포함 Convert.ToByte(String, Int32) 또는 Byte.Parse(String, NumberStyles)합니다.Such methods include Convert.ToByte(String, Int32) or Byte.Parse(String, NumberStyles).

ToString(UInt64) ToString(UInt64) ToString(UInt64) ToString(UInt64)

중요

이 API는 CLS 규격이 아닙니다.

지정된 64비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.

public:
 static System::String ^ ToString(System::UInt64 value);
[System.CLSCompliant(false)]
public static string ToString (ulong value);
static member ToString : uint64 -> string
Public Shared Function ToString (value As ULong) As String

매개 변수

value
UInt64 UInt64 UInt64 UInt64

변환할 64비트 부호 없는 정수입니다.The 64-bit unsigned integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현으로 부호 없는 정수 (long) 배열에서 각 요소를 변환합니다.The following example converts each element in an unsigned long integer array to its equivalent string representation.

ulong[] numbers = { UInt64.MinValue, 1031, 189045, UInt64.MaxValue };
string result;

foreach (ulong number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt64 value 0 to the String value 0.
//    Converted the UInt64 value 1031 to the String value 1031.
//    Converted the UInt64 value 189045 to the String value 189045.
//    Converted the UInt64 value 18446744073709551615 to the String value 18446744073709551615.
Dim numbers() As ULong = { UInt64.MinValue, 1031, 189045, UInt64.MaxValue }
Dim result As String

For Each number As ULong In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the UInt64 value 0 to the String value 0.
'    Converted the UInt64 value 1031 to the String value 1031.
'    Converted the UInt64 value 189045 to the String value 189045.
'    Converted the UInt64 value 18446744073709551615 to the String value 18446744073709551615.

설명

이 구현은 UInt64.ToString()합니다.This implementation is identical to UInt64.ToString().

ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider) ToString(Boolean, IFormatProvider)

지정된 부울 값을 해당하는 문자열 표현으로 변환합니다.Converts the specified Boolean value to its equivalent string representation.

public:
 static System::String ^ ToString(bool value, IFormatProvider ^ provider);
public static string ToString (bool value, IFormatProvider provider);
static member ToString : bool * IFormatProvider -> string
Public Shared Function ToString (value As Boolean, provider As IFormatProvider) As String

매개 변수

value
Boolean Boolean Boolean Boolean

변환할 부울 값입니다.The Boolean value to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

개체의 인스턴스입니다.An instance of an object. 이 매개 변수는 무시됩니다.This parameter is ignored.

반환

value의 문자열 표현입니다.The string representation of value.

예제

변환 하는 다음 예제는 Boolean 값을 String 사용 하 여를 ToString 메서드를 사용 하 여는 IFormatProvider 호출 하는 형식 공급자의 유형을 표시 하는 개체입니다.The following example converts a Boolean value to a String with the ToString method, using an IFormatProvider object that displays the type of the format provider for which it is called. 예제에 따르면는 IFormatProvider 개체 참조 되지 않은 합니다.The example shows that the IFormatProvider object is not referenced.

// Example of Convert::ToString( non-numeric types, IFormatProvider ).
using namespace System;
using namespace System::Globalization;

#define null (Object^)0

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
ref class DummyProvider: public IFormatProvider
{
public:

   // Normally, GetFormat returns an object of the requested type
   // (usually itself) if it is able; otherwise, it returns Nothing. 
   virtual Object^ GetFormat( Type^ argType )
   {
      // Here, the type of argType is displayed, and GetFormat
      // always returns Nothing.
      Console::Write( "{0,-40}", argType->ToString() );
      return null;
   }
};

int main()
{
   // Create an instance of the IFormatProvider.
   DummyProvider^ provider = gcnew DummyProvider;
   String^ converted;

   // Convert these values using DummyProvider.
   int Int32A = -252645135;
   double DoubleA = 61680.3855;
   Object^ ObjDouble =  -98765.4321;
   DateTime DayTimeA = DateTime(2001,9,11,13,45,0);
   bool BoolA = true;
   String^ StringA = "Qwerty";
   Char CharA = '$';
   TimeSpan TSpanA = TimeSpan(0,18,0);
   Object^ ObjOther = static_cast<Object^>(provider);
   Console::WriteLine( "This example of "
   "Convert::ToString( non-numeric, IFormatProvider* ) \n"
   "generates the following output. The provider type, "
   "argument type, \nand argument value are displayed." );
   Console::WriteLine( "\nNote: The IFormatProvider object is "
   "not called for Boolean, String, \nChar, TimeSpan, "
   "and non-numeric Object." );

   // The format provider is called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( Int32A, provider );
   Console::WriteLine( "int      {0}", converted );
   converted = Convert::ToString( DoubleA, provider );
   Console::WriteLine( "double   {0}", converted );
   converted = Convert::ToString( ObjDouble, provider );
   Console::WriteLine( "Object   {0}", converted );
   converted = Convert::ToString( DayTimeA, provider );
   Console::WriteLine( "DateTime {0}", converted );

   // The format provider is not called for these conversions.
   Console::WriteLine();
   converted = Convert::ToString( BoolA, provider );
   Console::WriteLine( "bool     {0}", converted );
   converted = Convert::ToString( StringA, provider );
   Console::WriteLine( "String   {0}", converted );
   converted = Convert::ToString( CharA, provider );
   Console::WriteLine( "Char     {0}", converted );
   converted = Convert::ToString( TSpanA, provider );
   Console::WriteLine( "TimeSpan {0}", converted );
   converted = Convert::ToString( ObjOther, provider );
   Console::WriteLine( "Object   {0}", converted );
}

/*
This example of Convert::ToString( non-numeric, IFormatProvider* )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   Object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
String   Qwerty
Char     $
TimeSpan 00:18:00
Object   DummyProvider
*/
// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require 
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing. 
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/ 
' Example of Convert.ToString( non-numeric types, IFormatProvider ).
Imports System.Globalization

' An instance of this class can be passed to methods that require 
' an IFormatProvider.
Public Class DummyProvider
    Implements IFormatProvider

    ' Normally, GetFormat returns an object of the requested type
    ' (usually itself) if it is able; otherwise, it returns Nothing. 
    Public Function GetFormat( argType As Type ) As Object _
        Implements IFormatProvider.GetFormat

        ' Here, the type of argType is displayed, and GetFormat
        ' always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) )
        Return Nothing

    End Function 
End Class

Module ConvertNonNumericProviderDemo

    Sub Main( )

        ' Create an instance of the IFormatProvider.
        Dim provider    As New DummyProvider( )
        Dim converted   As String

        ' Convert these values using DummyProvider.
        Dim Int32A      As Integer  = -252645135   
        Dim DoubleA     As Double   = 61680.3855
        Dim ObjDouble   As Object   = CType( -98765.4321, Object )
        Dim DayTimeA    As DateTime = _
                            new DateTime( 2001, 9, 11, 13, 45, 0 )

        Dim BoolA       As Boolean  = True
        Dim StringA     As String   = "Qwerty"
        Dim CharA       As Char     = "$"c
        Dim TSpanA      As TimeSpan = New TimeSpan( 0, 18, 0 )
        Dim ObjOther    As Object   = CType( provider, Object )

        Console.WriteLine( "This example of " & _
            "Convert.ToString( non-numeric, IFormatProvider ) " & _
            vbCrLf & "generates the following output. The " & _
            "provider type, argument type, " & vbCrLf & "and " & _
            "argument value are displayed." )
        Console.WriteLine( vbCrLf & _
            "Note: The IFormatProvider object is not called for " & _
            "Boolean, String, " & vbCrLf & "Char, TimeSpan, " & _
            "and non-numeric Object." )

        ' The format provider is called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( Int32A, provider )
        Console.WriteLine( "Int32    {0}", converted )
        converted =  Convert.ToString( DoubleA, provider )
        Console.WriteLine( "Double   {0}", converted )
        converted =  Convert.ToString( ObjDouble, provider )
        Console.WriteLine( "Object   {0}", converted )
        converted =  Convert.ToString( DayTimeA, provider )
        Console.WriteLine( "DateTime {0}", converted )

        ' The format provider is not called for these conversions.
        Console.WriteLine( )
        converted =  Convert.ToString( BoolA, provider )
        Console.WriteLine( "Boolean  {0}", converted )
        converted =  Convert.ToString( StringA, provider )
        Console.WriteLine( "String   {0}", converted )
        converted =  Convert.ToString( CharA, provider )
        Console.WriteLine( "Char     {0}", converted )
        converted =  Convert.ToString( TSpanA, provider )
        Console.WriteLine( "TimeSpan {0}", converted )
        converted =  Convert.ToString( ObjOther, provider )
        Console.WriteLine( "Object   {0}", converted )

    End Sub
End Module

' This example of Convert.ToString( non-numeric, IFormatProvider )
' generates the following output. The provider type, argument type,
' and argument value are displayed.
'
' Note: The IFormatProvider object is not called for Boolean, String,
' Char, TimeSpan, and non-numeric Object.
' 
' System.Globalization.NumberFormatInfo   Int32    -252645135
' System.Globalization.NumberFormatInfo   Double   61680.3855
' System.Globalization.NumberFormatInfo   Object   -98765.4321
' System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM
' 
' Boolean  True
' String   Qwerty
' Char     $
' TimeSpan 00:18:00
' Object   DummyProvider

설명

이 구현은 Boolean.ToString합니다.This implementation is identical to Boolean.ToString. 반환 Boolean.TrueString 에 대 한 true 값 및 Boolean.FalseString 에 대 한 false 값입니다.It returns Boolean.TrueString for true values and Boolean.FalseString for false values.

ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider) ToString(Byte, IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여, 지정된 8비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

public:
 static System::String ^ ToString(System::Byte value, IFormatProvider ^ provider);
public static string ToString (byte value, IFormatProvider provider);
static member ToString : byte * IFormatProvider -> string
Public Shared Function ToString (value As Byte, provider As IFormatProvider) As String

매개 변수

value
Byte Byte Byte Byte

변환할 8비트 부호 없는 정수입니다.The 8-bit unsigned integer to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 EN-US 및 FR-FR 문화권의 서식 규칙을 사용 하 여 해당 문자열 표현으로 부호 없는 바이트 배열 각 요소를 변환 합니다.The following example converts each element in an unsigned byte array to its equivalent string representation using the formatting conventions of the en-US and fr-FR cultures. 기본적으로 "G" 지정자만 진수 바이트 값의 문자열 표현에 출력 하기 때문에 provider 매개 변수는 반환 된 문자열의 서식을 영향을 주지 않습니다.Because the "G" specifier by default outputs only decimal digits in a byte value's string representation, the provider parameter does not affect the formatting of the returned string.

byte[] numbers = { 12, 100, Byte.MaxValue };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR" };

foreach (byte number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}   
// The example displays the following output:
//       12:
//          en-US:                   12
//          fr-FR:                   12
//       
//       100:
//          en-US:                  100
//          fr-FR:                  100
//       
//       255:
//          en-US:                  255
//          fr-FR:                  255      
' Define an array of numbers to display.
Dim numbers() As Byte = { 12, 100, Byte.MaxValue }
' Define the culture names used to display them.
Dim cultureNames() As String = { "en-US", "fr-FR" }

For Each number As Byte In numbers
   Console.WriteLine("{0}:", Convert.ToString(number, _
                             System.Globalization.CultureInfo.InvariantCulture))
   For Each cultureName As String In cultureNames
      Dim culture As New System.Globalization.CultureInfo(cultureName)
      Console.WriteLine("   {0}: {1,20}", _
                        culture.Name, Convert.ToString(number, culture))
   Next
   Console.WriteLine()
Next   
' The example displays the following output:
'       12:
'          en-US:                   12
'          fr-FR:                   12
'       
'       100:
'          en-US:                  100
'          fr-FR:                  100
'       
'       255:
'          en-US:                  255
'          fr-FR:                  255      

설명

이 구현은 Byte.ToString합니다.This implementation is identical to Byte.ToString.

ToString(Boolean) ToString(Boolean) ToString(Boolean) ToString(Boolean)

지정된 부울 값을 해당하는 문자열 표현으로 변환합니다.Converts the specified Boolean value to its equivalent string representation.

public:
 static System::String ^ ToString(bool value);
public static string ToString (bool value);
static member ToString : bool -> string
Public Shared Function ToString (value As Boolean) As String

매개 변수

value
Boolean Boolean Boolean Boolean

변환할 부울 값입니다.The Boolean value to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 변환을 BooleanString를 사용 하 여 ToString입니다.The following example illustrates the conversion of a Boolean to a String, using ToString. 변환 후 반환 된 문자열이 일치 하거나 하는 방법도 보여 줍니다 Boolean.TrueString 또는 Boolean.FalseString합니다.It also illustrates that the string returned by the conversion equals either Boolean.TrueString or Boolean.FalseString.

bool falseFlag = false;
bool trueFlag = true;

Console.WriteLine(Convert.ToString(falseFlag));
Console.WriteLine(Convert.ToString(falseFlag).Equals(Boolean.FalseString));
Console.WriteLine(Convert.ToString(trueFlag));
Console.WriteLine(Convert.ToString(trueFlag).Equals(Boolean.TrueString));
// The example displays the following output:
//       False
//       True
//       True
//       True
Dim falseFlag As Boolean = False
Dim trueFlag As Boolean = True

Console.WriteLine(Convert.ToString(falseFlag))
Console.WriteLine(Convert.ToString(falseFlag).Equals(Boolean.FalseString))
Console.WriteLine(Convert.ToString(trueFlag))
Console.WriteLine(Convert.ToString(trueFlag).Equals(Boolean.TrueString))
' The example displays the following output:
'       False
'       True
'       True
'       True      
let falseFlag = false
let trueFlag = true

Console.WriteLine (Convert.ToString falseFlag)
Console.WriteLine (Convert.ToString falseFlag=Boolean.FalseString)
Console.WriteLine (Convert.ToString trueFlag)
Console.WriteLine (Convert.ToString trueFlag=Boolean.TrueString)
// The example displays the following output:
//       False
//       True
//       True
//       True

설명

이 구현은 Boolean.ToString합니다.This implementation is identical to Boolean.ToString. 반환 Boolean.TrueString 에 대 한 true 값 및 Boolean.FalseString 에 대 한 false 값입니다.It returns Boolean.TrueString for true values and Boolean.FalseString for false values.

ToString(Byte) ToString(Byte) ToString(Byte) ToString(Byte)

지정된 8비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit unsigned integer to its equivalent string representation.

public:
 static System::String ^ ToString(System::Byte value);
public static string ToString (byte value);
static member ToString : byte -> string
Public Shared Function ToString (value As Byte) As String

매개 변수

value
Byte Byte Byte Byte

변환할 8비트 부호 없는 정수입니다.The 8-bit unsigned integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 변환에서 각 값에는 Byte 문자열 배열입니다.The following example converts each value in a Byte array to a string.

using System;

public class Example
{
   public static void Main()
   {
      byte[] values = { Byte.MinValue, 12, 100, 179, Byte.MaxValue } ;

      foreach (var value in values)
         Console.WriteLine("{0,3} ({1}) --> {2}", value, 
                           value.GetType().Name, 
                           Convert.ToString(value));      
   }
}
// The example displays the following output:
//       0 (Byte) --> 0
//      12 (Byte) --> 12
//     100 (Byte) --> 100
//     179 (Byte) --> 179
//     255 (Byte) --> 255
Public Module Example
   Public Sub Main()
      Dim values() As Byte = { Byte.MinValue, 12, 100, 179, Byte.MaxValue }

      For Each value In values
         Console.WriteLine("{0,3} ({1}) --> {2}", value, 
                           value.GetType().Name, 
                           Convert.ToString(value))
      Next                           
   End Sub
End Module
' The example displays the following output:
'       0 (Byte) --> 0
'      12 (Byte) --> 12
'     100 (Byte) --> 100
'     179 (Byte) --> 179
'     255 (Byte) --> 255
let values = [ Byte.MinValue; 12uy; 100uy; 179uy; Byte.MaxValue ]
for value in values do
    printfn "% 4i (%s) --> %s" value (value.GetType().Name) (Convert.ToString value)
// The example displays the following output:
//       0 (Byte) --> 0
//      12 (Byte) --> 12
//     100 (Byte) --> 100
//     179 (Byte) --> 179
//     255 (Byte) --> 255

설명

이 구현은 Byte.ToString()합니다.This implementation is identical to Byte.ToString().

ToString(Char) ToString(Char) ToString(Char) ToString(Char)

지정된 유니코드 문자의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified Unicode character to its equivalent string representation.

public:
 static System::String ^ ToString(char value);
public static string ToString (char value);
static member ToString : char -> string
Public Shared Function ToString (value As Char) As String

매개 변수

value
Char Char Char Char

변환할 유니코드 문자입니다.The Unicode character to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제는 CharString합니다.The following example converts a Char to a String.

public:
   void ConvertStringChar( String^ stringVal )
   {
      Char charVal = 'a';
      
      // A String must be one character long to convert to char.
      try
      {
         charVal = System::Convert::ToChar( stringVal );
         System::Console::WriteLine( " {0} as a char is {1}",
            stringVal, charVal );
      }
      catch ( System::FormatException^ ) 
      {
         System::Console::WriteLine(
            "The String is longer than one character." );
      }
      catch ( System::ArgumentNullException^ ) 
      {
         System::Console::WriteLine( "The String is 0." );
      }
      
      // A char to String conversion will always succeed.
      stringVal = System::Convert::ToString( charVal );
      System::Console::WriteLine( "The character as a String is {0}",
         stringVal );
   }
public void ConvertStringChar(string stringVal) {
	char charVal = 'a';

	// A string must be one character long to convert to char.
	try {
		charVal = System.Convert.ToChar(stringVal);
		System.Console.WriteLine("{0} as a char is {1}",
			stringVal, charVal);
	}
	catch (System.FormatException) {
		System.Console.WriteLine(
			"The string is longer than one character.");
	}
	catch (System.ArgumentNullException) {
		System.Console.WriteLine("The string is null.");
	}

	// A char to string conversion will always succeed.
	stringVal = System.Convert.ToString(charVal);
	System.Console.WriteLine("The character as a string is {0}",
			stringVal);
}
Public Sub ConvertStringChar(ByVal stringVal As String)
    Dim charVal As Char = "a"c

    ' A string must be one character long to convert to char.
    Try
        charVal = System.Convert.ToChar(stringVal)
        System.Console.WriteLine("{0} as a char is {1}", _
                                  stringVal, charVal)
    Catch exception As System.FormatException
        System.Console.WriteLine( _
         "The string is longer than one character.")
    Catch exception As System.ArgumentNullException
        System.Console.WriteLine("The string is null.")
    End Try

    ' A char to string conversion will always succeed.
    stringVal = System.Convert.ToString(charVal)
    System.Console.WriteLine("The character as a string is {0}", _
                              stringVal)
End Sub

설명

이 구현은 Char.ToString합니다.This implementation is identical to Char.ToString.

ToString(Decimal) ToString(Decimal) ToString(Decimal) ToString(Decimal)

지정된 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified decimal number to its equivalent string representation.

public:
 static System::String ^ ToString(System::Decimal value);
public static string ToString (decimal value);
static member ToString : decimal -> string
Public Shared Function ToString (value As Decimal) As String

매개 변수

value
Decimal Decimal Decimal Decimal

변환할 10진수입니다.The decimal number to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제는 DecimalString합니다.The following example converts a Decimal to a String.

public:
   void ConvertStringDecimal( String^ stringVal )
   {
      Decimal decimalVal = 0;

      try
      {
         decimalVal = System::Convert::ToDecimal( stringVal );
         System::Console::WriteLine( "The String as a decimal is {0}.",
         decimalVal );
      }
      catch ( System::OverflowException^ ) 
      {
         System::Console::WriteLine(
            "The conversion from String to decimal overflowed." );
      }
      catch ( System::FormatException^ ) 
      {
         System::Console::WriteLine(
            "The String is not formatted as a decimal." );
      }
      catch ( System::ArgumentNullException^ ) 
      {
         System::Console::WriteLine( "The String is 0." );
      }
      
      // Decimal to String conversion will not overflow.
      stringVal = System::Convert::ToString( decimalVal );
      System::Console::WriteLine(
         "The decimal as a String is {0}.", stringVal );
   }
public void ConvertStringDecimal(string stringVal) {
	decimal decimalVal = 0;
	
	try {
		decimalVal = System.Convert.ToDecimal(stringVal);
		System.Console.WriteLine(
			"The string as a decimal is {0}.", decimalVal);
	} 
	catch (System.OverflowException){
		System.Console.WriteLine(
			"The conversion from string to decimal overflowed.");
	}
	catch (System.FormatException) {
		System.Console.WriteLine(
			"The string is not formatted as a decimal.");
	}
	catch (System.ArgumentNullException) {
		System.Console.WriteLine(
			"The string is null.");
	}

	// Decimal to string conversion will not overflow.
	stringVal = System.Convert.ToString(decimalVal);
	System.Console.WriteLine(
		"The decimal as a string is {0}.", stringVal);
}	
Public Sub ConvertStringDecimal(ByVal stringVal As String)
    Dim decimalVal As Decimal = 0

    Try
        decimalVal = System.Convert.ToDecimal(stringVal)
        System.Console.WriteLine("The string as a decimal is {0}.", _
                                  decimalVal)
    Catch exception As System.OverflowException
        System.Console.WriteLine( _
            "Overflow in string-to-decimal conversion.")
    Catch exception As System.FormatException
        System.Console.WriteLine( _
            "The string is not formatted as a decimal.")
    Catch exception As System.ArgumentException
        System.Console.WriteLine("The string is null.")
    End Try

    ' Decimal to string conversion will not overflow.
    stringVal = System.Convert.ToString(decimalVal)
    System.Console.WriteLine("The decimal as a string is {0}.", _
                              stringVal)
End Sub

설명

이 구현은 Decimal.ToString()합니다.This implementation is identical to Decimal.ToString().

ToString(Double) ToString(Double) ToString(Double) ToString(Double)

지정된 배정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified double-precision floating-point number to its equivalent string representation.

public:
 static System::String ^ ToString(double value);
public static string ToString (double value);
static member ToString : double -> string
Public Shared Function ToString (value As Double) As String

매개 변수

value
Double Double Double Double

변환할 배정밀도 부동 소수점 숫자입니다.The double-precision floating-point number to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제는 DoubleString합니다.The following example converts a Double to a String.

public:
   void ConvertDoubleString( double doubleVal )
   {
      String^ stringVal;
      
      // A conversion from Double to String cannot overflow.
      stringVal = System::Convert::ToString( doubleVal );
      System::Console::WriteLine( " {0} as a String is: {1}",
         doubleVal, stringVal );
      try
      {
         doubleVal = System::Convert::ToDouble( stringVal );
         System::Console::WriteLine( " {0} as a double is: {1}",
         stringVal, doubleVal );
      }
      catch ( System::OverflowException^ ) 
      {
         System::Console::WriteLine( "Conversion from String-to-double overflowed." );
      }
      catch ( System::FormatException^ ) 
      {
         System::Console::WriteLine( "The String was not formatted as a double." );
      }
      catch ( System::ArgumentException^ ) 
      {
         System::Console::WriteLine( "The String pointed to null." );
      }
   }
public void ConvertDoubleString(double doubleVal) {
	
	string	stringVal;     

	// A conversion from Double to string cannot overflow.       
	stringVal = System.Convert.ToString(doubleVal);
	System.Console.WriteLine("{0} as a string is: {1}",
		doubleVal, stringVal);

	try {
		doubleVal = System.Convert.ToDouble(stringVal);
		System.Console.WriteLine("{0} as a double is: {1}",
			stringVal, doubleVal);
	} 
	catch (System.OverflowException) {
		System.Console.WriteLine(
			"Conversion from string-to-double overflowed.");
	}
	catch (System.FormatException) {
		System.Console.WriteLine(
			"The string was not formatted as a double.");
	}
	catch (System.ArgumentException) {
		System.Console.WriteLine(
			"The string pointed to null.");
	}
}
Public Sub ConvertDoubleString(ByVal doubleVal As Double)

    Dim stringVal As String

    ' A conversion from Double to String cannot overflow.       
    stringVal = System.Convert.ToString(doubleVal)
    System.Console.WriteLine("{0} as a String is: {1}", _
                              doubleVal, stringVal)

    Try
        doubleVal = System.Convert.ToDouble(stringVal)
        System.Console.WriteLine("{0} as a Double is: {1}", _
                                  stringVal, doubleVal)
    Catch exception As System.OverflowException
        System.Console.WriteLine( _
            "Overflow in String-to-Double conversion.")
    Catch exception As System.FormatException
        System.Console.WriteLine( _
            "The string is not formatted as a Double.")
    Catch exception As System.ArgumentException
        System.Console.WriteLine("The string is null.")
    End Try

End Sub

설명

이 구현은 Double.ToString()합니다.This implementation is identical to Double.ToString().

ToString(Int16) ToString(Int16) ToString(Int16) ToString(Int16)

지정된 16비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit signed integer to its equivalent string representation.

public:
 static System::String ^ ToString(short value);
public static string ToString (short value);
static member ToString : int16 -> string
Public Shared Function ToString (value As Short) As String

매개 변수

value
Int16 Int16 Int16 Int16

변환할 16비트 부호 있는 정수입니다.The 16-bit signed integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현으로 16 비트 정수의 배열 각 요소를 변환합니다.The following example converts each element in an array of 16-bit integers to its equivalent string representation.

short[] numbers = { Int16.MinValue, -138, 0, 19, Int16.MaxValue };
string result;

foreach (short number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}     
// The example displays the following output:
//    Converted the Int16 value -32768 to the String value -32768.
//    Converted the Int16 value -138 to the String value -138.
//    Converted the Int16 value 0 to the String value 0.
//    Converted the Int16 value 19 to the String value 19.
//    Converted the Int16 value 32767 to the String value 32767.
Dim numbers() As Short = { Int16.MinValue, -138, 0, 19, Int16.MaxValue }
Dim result As String

For Each number As Short In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next     
' The example displays the following output:
'    Converted the Int16 value -32768 to the String value -32768.
'    Converted the Int16 value -138 to the String value -138.
'    Converted the Int16 value 0 to the String value 0.
'    Converted the Int16 value 19 to the String value 19.
'    Converted the Int16 value 32767 to the String value 32767.

설명

이 구현은 Int16.ToString()합니다.This implementation is identical to Int16.ToString().

ToString(DateTime) ToString(DateTime) ToString(DateTime) ToString(DateTime)

지정된 DateTime의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified DateTime to its equivalent string representation.

public:
 static System::String ^ ToString(DateTime value);
public static string ToString (DateTime value);
static member ToString : DateTime -> string
Public Shared Function ToString (value As DateTime) As String

매개 변수

value
DateTime DateTime DateTime DateTime

변환할 날짜 및 시간 값입니다.The date and time value to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

배열의 각 요소를 변환 하는 다음 예제는 DateTime 값을 String 값입니다.The following example converts each element in an array of a DateTime value to a String value.

DateTime[] dates = { new DateTime(2009, 7, 14), 
                     new DateTime(1, 1, 1, 18, 32, 0), 
                     new DateTime(2009, 2, 12, 7, 16, 0) };
string result;

foreach (DateTime dateValue in dates)
{
   result = Convert.ToString(dateValue);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        dateValue.GetType().Name, dateValue,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the DateTime value 7/14/2009 12:00:00 AM to a String value 7/14/2009 12:00:00 AM.
//    Converted the DateTime value 1/1/0001 06:32:00 PM to a String value 1/1/0001 06:32:00 PM.
//    Converted the DateTime value 2/12/2009 07:16:00 AM to a String value 2/12/2009 07:16:00 AM.
Dim dates() As Date = { #07/14/2009#, #6:32PM#, #02/12/2009 7:16AM#}
Dim result As String

For Each dateValue As Date In dates
   result = Convert.ToString(dateValue)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        dateValue.GetType().Name, dateValue, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the DateTime value 7/14/2009 12:00:00 AM to a String value 7/14/2009 12:00:00 AM.
'    Converted the DateTime value 1/1/0001 06:32:00 PM to a String value 1/1/0001 06:32:00 PM.
'    Converted the DateTime value 2/12/2009 07:16:00 AM to a String value 2/12/2009 07:16:00 AM.

설명

이 구현은 DateTime.ToString()합니다.This implementation is identical to DateTime.ToString(). 현재 문화권 및 "G" 형식 지정자의 서식 규칙을 사용 하 여 변환 하는 DateTime 값을 해당 문자열 표현입니다.It uses the formatting conventions of the current culture and the "G" format specifier to convert a DateTime value to its string representation.

ToString(Int64) ToString(Int64) ToString(Int64) ToString(Int64)

지정된 64비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 64-bit signed integer to its equivalent string representation.

public:
 static System::String ^ ToString(long value);
public static string ToString (long value);
static member ToString : int64 -> string
Public Shared Function ToString (value As Long) As String

매개 변수

value
Int64 Int64 Int64 Int64

변환할 64비트 부호 있는 정수입니다.The 64-bit signed integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현에는 정수 (long) 배열에서 각 요소를 변환합니다.The following example converts each element in a long integer array to its equivalent string representation.

// Create a NumberFormatInfo object and set several of its
// properties that control default integer formatting.
System.Globalization.NumberFormatInfo provider = new System.Globalization.NumberFormatInfo();
provider.NegativeSign = "minus ";

long[] values = { -200, 0, 1000 };

foreach (long value in values)
   Console.WriteLine("{0,-6}  -->  {1,10}", 
                     value, Convert.ToString(value, provider));
// The example displays the following output:
//       -200    -->   minus 200
//       0       -->           0
//       1000    -->        1000
' Create a NumberFormatInfo object and set several of its
' properties that control default integer formatting.
Dim provider As New System.Globalization.NumberFormatInfo()
provider.NegativeSign = "minus "

Dim values() As Long = { -200, 0, 1000 }

For Each value As Long In values
   Console.WriteLine("{0,-6}  -->  {1,10}", _
                     value, Convert.ToString(value, provider))
Next
' The example displays the following output:
'       -200    -->   minus 200
'       0       -->           0
'       1000    -->        1000

설명

이 구현은 Int64.ToString()합니다.This implementation is identical to Int64.ToString().

ToString(Object) ToString(Object) ToString(Object) ToString(Object)

지정된 개체의 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified object to its equivalent string representation.

public:
 static System::String ^ ToString(System::Object ^ value);
public static string ToString (object value);
static member ToString : obj -> string
Public Shared Function ToString (value As Object) As String

매개 변수

value
Object Object Object Object

변환할 값을 제공하는 개체나 null입니다.An object that supplies the value to convert, or null.

반환

valuenull인 경우 value 또는 Empty 값의 문자열 표현입니다.The string representation of value, or Empty if value is null.

예제

다음 예제에서는 개체 배열의 각 요소는 문자열 표현으로 변환 합니다.The following example converts each element in an object array to its equivalent string representation.

object[] values = { false, 12.63m, new DateTime(2009, 6, 1, 6, 32, 15), 16.09e-12,
                    'Z', 15.15322, SByte.MinValue, Int32.MaxValue };
string result;

foreach (object value in values)
{
   result = Convert.ToString(value);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        value.GetType().Name, value,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the Boolean value False to the String value False.
//    Converted the Decimal value 12.63 to the String value 12.63.
//    Converted the DateTime value 6/1/2009 06:32:15 AM to the String value 6/1/2009 06:32:15 AM.
//    Converted the Double value 1.609E-11 to the String value 1.609E-11.
//    Converted the Char value Z to the String value Z.
//    Converted the Double value 15.15322 to the String value 15.15322.
//    Converted the SByte value -128 to the String value -128.
//    Converted the Int32 value 2147483647 to the String value 2147483647.      
Dim values() As Object = { False, 12.63d, #06/01/2009 6:32:15#, 16.09e-12, _
                           "Z"c, 15.15322, SByte.MinValue, Int32.MaxValue}
Dim result As String

For Each value As Object In values
   result = Convert.ToString(value)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        value.GetType().Name, value, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the Boolean value False to the String value False.
'    Converted the Decimal value 12.63 to the String value 12.63.
'    Converted the DateTime value 6/1/2009 06:32:15 AM to the String value 6/1/2009 06:32:15 AM.
'    Converted the Double value 1.609E-11 to the String value 1.609E-11.
'    Converted the Char value Z to the String value Z.
'    Converted the Double value 15.15322 to the String value 15.15322.
'    Converted the SByte value -128 to the String value -128.
'    Converted the Int32 value 2147483647 to the String value 2147483647.      

설명

변환할 value 문자열 표현으로 메서드를 호출 하려고 합니다 IConvertible.ToString 구현의 value합니다.To convert value to its string representation, the method tries to call the IConvertible.ToString implementation of value. 하는 경우 value 를 구현 하지 않습니다는 IConvertible 인터페이스 메서드를 호출 하려고 합니다 IFormattable.ToString 구현의 value합니다.If value does not implement the IConvertible interface, the method tries to call the IFormattable.ToString implementation of value. 값을 구현 하지 않는 경우는 IFormattable 인터페이스를 메서드 호출을 ToString 기본 형식의 메서드 value.If value does not implement the IFormattable interface, the method calls the ToString method of the underlying type of value.

ToString(SByte) ToString(SByte) ToString(SByte) ToString(SByte)

중요

이 API는 CLS 규격이 아닙니다.

지정된 8비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 8-bit signed integer to its equivalent string representation.

public:
 static System::String ^ ToString(System::SByte value);
[System.CLSCompliant(false)]
public static string ToString (sbyte value);
static member ToString : sbyte -> string
Public Shared Function ToString (value As SByte) As String

매개 변수

value
SByte SByte SByte SByte

변환할 8비트 부호 있는 정수입니다.The 8-bit signed integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현으로는 부호 있는 바이트 배열에서 각 요소를 변환합니다.The following example converts each element in a signed byte array to its equivalent string representation.

sbyte[] numbers = { SByte.MinValue, -12, 0, 16, SByte.MaxValue };
string result;

foreach (sbyte number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the SByte value -128 to the String value -128.
//    Converted the SByte value -12 to the String value -12.
//    Converted the SByte value 0 to the String value 0.
//    Converted the SByte value 16 to the String value 16.
//    Converted the SByte value 127 to the String value 127.
Dim numbers() As SByte = { SByte.MinValue, -12, 0, 16, SByte.MaxValue }
Dim result As String

For Each number As SByte In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the SByte value -128 to the String value -128.
'    Converted the SByte value -12 to the String value -12.
'    Converted the SByte value 0 to the String value 0.
'    Converted the SByte value 16 to the String value 16.
'    Converted the SByte value 127 to the String value 127.

설명

이 구현은 SByte.ToString()합니다.This implementation is identical to SByte.ToString().

ToString(Single) ToString(Single) ToString(Single) ToString(Single)

지정된 단정밀도 부동 소수점 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified single-precision floating-point number to its equivalent string representation.

public:
 static System::String ^ ToString(float value);
public static string ToString (float value);
static member ToString : single -> string
Public Shared Function ToString (value As Single) As String

매개 변수

value
Single Single Single Single

변환할 단정밀도 부동 소수점 숫자입니다.The single-precision floating-point number to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 배열의 각 요소를 변환 Single 값을 해당 문자열 표현입니다.The following example converts each element in an array of Single values to its equivalent string representation.

float[] numbers = { Single.MinValue, -1011.351f, -17.45f, -3e-16f,
                    0f, 4.56e-12f, 16.0001f, 10345.1221f, Single.MaxValue };
string result;

foreach (float number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}                            
// The example displays the following output:
//    Converted the Single value -3.402823E+38 to the String value -3.402823E+38.
//    Converted the Single value -1011.351 to the String value -1011.351.
//    Converted the Single value -17.45 to the String value -17.45.
//    Converted the Single value -3E-16 to the String value -3E-16.
//    Converted the Single value 0 to the String value 0.
//    Converted the Single value 4.56E-12 to the String value 4.56E-12.
//    Converted the Single value 16.0001 to the String value 16.0001.
//    Converted the Single value 10345.12 to the String value 10345.12.
//    Converted the Single value 3.402823E+38 to the String value 3.402823E+38.
Dim numbers() As Single = { Single.MinValue, -1011.351, -17.45, -3e-16, _
                            0, 4.56e-12, 16.0001, 10345.1221, Single.MaxValue }
Dim result As String

For Each number As Single In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next                            
' The example displays the following output:
'    Converted the Single value -3.402823E+38 to the String value -3.402823E+38.
'    Converted the Single value -1011.351 to the String value -1011.351.
'    Converted the Single value -17.45 to the String value -17.45.
'    Converted the Single value -3E-16 to the String value -3E-16.
'    Converted the Single value 0 to the String value 0.
'    Converted the Single value 4.56E-12 to the String value 4.56E-12.
'    Converted the Single value 16.0001 to the String value 16.0001.
'    Converted the Single value 10345.12 to the String value 10345.12.
'    Converted the Single value 3.402823E+38 to the String value 3.402823E+38.

설명

이 구현은 Single.ToString()합니다.This implementation is identical to Single.ToString().

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 문자열 인스턴스를 실제 변환 작업 없이 반환합니다.Returns the specified string instance; no actual conversion is performed.

public:
 static System::String ^ ToString(System::String ^ value);
public static string ToString (string value);
static member ToString : string -> string
Public Shared Function ToString (value As String) As String

매개 변수

value
String String String String

반환할 문자열입니다.The string to return.

반환

value를 변경하지 않고 반환합니다.value is returned unchanged.

예제

다음 예제에서는 문자열을 전달 합니다 ToString(String) 메서드를 호출은 Object.ReferenceEquals 확인 메서드는 원래 문자열을 반환 하는 방법.The following example passes a string to the ToString(String) method and calls the Object.ReferenceEquals method to confirm that the method returns the original string. 또한 호출 하 여는 String.IsInterned 원래 문자열 내부 풀에 추가 되므로 두 문자열이 동일 하지 않은 확인 하는 방법입니다.The example also calls the String.IsInterned method to ensure that the two strings are not identical because the original string is interned.

using System;

public class Example
{
   public static void Main()
   {
      String article = "An";
      String noun = "apple";
      String str1 = String.Format("{0} {1}", article, noun);
      String str2 = Convert.ToString(str1);

      Console.WriteLine("str1 is interned: {0}",
                        ! (String.IsInterned(str1) == null));
      Console.WriteLine("str1 and str2 are the same reference: {0}",
                        Object.ReferenceEquals(str1, str2));
   }
}
// The example displays the following output:
//       str1 is interned: False
//       str1 and str2 are the same reference: True
Module Example
   Public Sub Main()
      Dim article As String = "An"
      Dim noun As String = "apple"
      Dim str1 As String = String.Format("{0} {1}", article, noun)
      Dim str2 As String = Convert.ToString(str1)

      Console.WriteLine("str1 is interned: {0}",
                        Not String.IsInterned(str1) Is Nothing)
      Console.WriteLine("str1 and str2 are the same reference: {0}",
                        Object.ReferenceEquals(str1, str2))
   End Sub
End Module
' The example displays the following output:
'       str1 is interned: False
'       str1 and str2 are the same reference: True

ToString(UInt16) ToString(UInt16) ToString(UInt16) ToString(UInt16)

중요

이 API는 CLS 규격이 아닙니다.

지정된 16비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 16-bit unsigned integer to its equivalent string representation.

public:
 static System::String ^ ToString(System::UInt16 value);
[System.CLSCompliant(false)]
public static string ToString (ushort value);
static member ToString : uint16 -> string
Public Shared Function ToString (value As UShort) As String

매개 변수

value
UInt16 UInt16 UInt16 UInt16

변환할 16비트 부호 없는 정수입니다.The 16-bit unsigned integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현으로 부호 없는 16 비트 정수 값의 배열 각 요소를 변환합니다.The following example converts each element in an array of unsigned 16-bit integer values to its equivalent string representation.

ushort[] numbers = { UInt16.MinValue, 103, 1045, UInt16.MaxValue };
string result;

foreach (ushort number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt16 value 0 to the String value 0.
//    Converted the UInt16 value 103 to the String value 103.
//    Converted the UInt16 value 1045 to the String value 1045.
//    Converted the UInt16 value 65535 to the String value 65535.
Dim numbers() As UShort = { UInt16.MinValue, 103, 1045, UInt16.MaxValue }
Dim result As String

For Each number As UShort In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the UInt16 value 0 to the String value 0.
'    Converted the UInt16 value 103 to the String value 103.
'    Converted the UInt16 value 1045 to the String value 1045.
'    Converted the UInt16 value 65535 to the String value 65535.

설명

이 구현은 UInt16.ToString()합니다.This implementation is identical to UInt16.ToString().

ToString(UInt32) ToString(UInt32) ToString(UInt32) ToString(UInt32)

중요

이 API는 CLS 규격이 아닙니다.

지정된 32비트 부호 없는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit unsigned integer to its equivalent string representation.

public:
 static System::String ^ ToString(System::UInt32 value);
[System.CLSCompliant(false)]
public static string ToString (uint value);
static member ToString : uint32 -> string
Public Shared Function ToString (value As UInteger) As String

매개 변수

value
UInt32 UInt32 UInt32 UInt32

변환할 32비트 부호 없는 정수입니다.The 32-bit unsigned integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 해당 문자열 표현으로 부호 없는 정수 배열의 각 요소를 변환합니다.The following example converts each element in an unsigned integer array to its equivalent string representation.

uint[] numbers = { UInt32.MinValue, 103, 1045, 119543, UInt32.MaxValue };
string result;

foreach (uint number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt32 value 0 to the String value 0.
//    Converted the UInt32 value 103 to the String value 103.
//    Converted the UInt32 value 1045 to the String value 1045.
//    Converted the UInt32 value 119543 to the String value 119543.
//    Converted the UInt32 value 4294967295 to the String value 4294967295.
Dim numbers() As UInteger = { UInt32.MinValue, 103, 1045, 119543, UInt32.MaxValue }
Dim result As String

For Each number As UInteger In numbers
   result = Convert.ToString(number)
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
Next
' The example displays the following output:
'    Converted the UInt32 value 0 to the String value 0.
'    Converted the UInt32 value 103 to the String value 103.
'    Converted the UInt32 value 1045 to the String value 1045.
'    Converted the UInt32 value 119543 to the String value 119543.
'    Converted the UInt32 value 4294967295 to the String value 4294967295.

설명

이 구현은 UInt32.ToString()합니다.This implementation is identical to UInt32.ToString().

ToString(Int32) ToString(Int32) ToString(Int32) ToString(Int32)

지정된 32비트 부호 있는 정수 값을 해당하는 문자열 표현으로 변환합니다.Converts the value of the specified 32-bit signed integer to its equivalent string representation.

public:
 static System::String ^ ToString(int value);
public static string ToString (int value);
static member ToString : int -> string
Public Shared Function ToString (value As Integer) As String

매개 변수

value
Int32 Int32 Int32 Int32

변환할 32비트 부호 있는 정수입니다.The 32-bit signed integer to convert.

반환

value의 문자열 표현입니다.The string representation of value.

예제

다음 예제에서는 비교 합니다 ToString(Int32) 메서드는 ToString(UInt16, IFormatProvider) 메서드.The following example compares the ToString(Int32) method with the ToString(UInt16, IFormatProvider) method. 사용자 지정 정의 NumberFormatInfo 음수 기호를 나타내는 문자열 "빼기"를 사용 하는 개체입니다.It defines a custom NumberFormatInfo object that uses the sting "minus" to represent the negative sign. 정수 배열의 각 요소 기본 서식 (현재 문화권의 서식 규칙) 및 사용자 지정 형식 공급자를 사용 하 여 해당 문자열 표현으로 변환 합니다.It converts each element in an integer array to its equivalent string representation using default formatting (the formatting conventions of the current culture) and the custom format provider.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Create a NumberFormatInfo object and set its NegativeSigns
      // property to use for integer formatting.
      NumberFormatInfo provider = new NumberFormatInfo();
      provider.NegativeSign = "minus ";

      int[] values = { -20, 0, 100 };
      
      Console.WriteLine("{0,-8} --> {1,10} {2,10}\n", "Value",
                         CultureInfo.CurrentCulture.Name,
                         "Custom");
      foreach (int value in values)
         Console.WriteLine("{0,-8} --> {1,10} {2,10}",
                           value, Convert.ToString(value),
                           Convert.ToString(value, provider));
      // The example displays output like the following:
      //       Value    -->      en-US     Custom
      //
      //       -20      -->        -20   minus 20
      //       0        -->          0          0
      //       100      -->        100        100
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Create a NumberFormatInfo object and set its NegativeSigns
      ' property to use for integer formatting.
      Dim provider As New NumberFormatInfo()
      provider.NegativeSign = "minus "

      Dim values() As Integer = { -20, 0, 100 }

      Console.WriteLine("{0,-8} --> {1,10} {2,10}", "Value",
                         CultureInfo.CurrentCulture.Name,
                         "Custom")
      Console.WriteLine()
      For Each value As Integer In values
         Console.WriteLine("{0,-8} --> {1,10} {2,10}",
                           value, Convert.ToString(value),
                           Convert.ToString(value, provider))
      Next
   End Sub
End Module
' The example displays output like the following:
'       Value    -->      en-US     Custom
'
'       -20      -->        -20   minus 20
'       0        -->          0          0
'       100      -->        100        100

설명

이 구현은 Int32.ToString()합니다.This implementation is identical to Int32.ToString(). 서식을 value 현재 스레드 문화권의 서식 규칙을 사용 하 여 합니다.It formats value by using the formatting conventions of the current thread culture.

적용 대상