Convert::ToString Method (Int64, Int32)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
static String^ ToString(
	long long value,
	int toBase
)

Parameters

value
Type: System::Int64

The 64-bit signed integer to convert.

toBase
Type: System::Int32

The base of the return value, which must be 2, 8, 10, or 16.

Return Value

Type: System::String^

The string representation of value in base toBase.

Exception Condition
ArgumentException

toBase is not 2, 8, 10, or 16.

If value is positive and toBase is not 10, the returned string uses sign-and-magnitude representation. If value is negative and toBase is not 10, the returned string uses two's complement representation. This means that the high-order bit of the highest-order byte (bit 63) is interpreted as the sign bit. 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. Such methods include Convert::ToInt64(String^, Int32) and Int64::Parse(String^, NumberStyles).

The following example converts each element in a long integer array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: