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.
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
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