Convert.ToString Method (Int64, Int32)
Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.
Assembly: mscorlib (in mscorlib.dll)
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.
| 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.
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
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