Int64.Parse Method (String)
Converts the string representation of a number to its 64-bit signed integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
-
Type:
System.String
A string containing a number to convert.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is null. |
| FormatException | s is not in the correct format. |
| OverflowException |
The s parameter contains a number of the form:
[ws][sign]digits[ws]
Elements in square brackets ([ and ]) are optional. The following table describes each element.
Element | Description |
|---|---|
ws | Optional white space. |
sign | An optional sign. |
digits | A sequence of digits ranging from 0 to 9. |
The s parameter is interpreted using the NumberStyles.Integer style. In addition to decimal digits, only leading and trailing spaces together with a leading sign are allowed. To explicitly define the style elements that can be present in s, use either the Int64.Parse(String, NumberStyles) or the Int64.Parse(String, NumberStyles, IFormatProvider) method.
The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. To parse a string using the formatting information of some other culture, use the Int64.Parse(String, NumberStyles, IFormatProvider) method.
The following example demonstrates how to convert a string value into a 64-bit signed integer value using the Int64.Parse(String) method. It then displays the resulting long integer value.
Module ParseInt64 Public Sub Main() Convert(" 179032 ") Convert(" -2041326 ") Convert(" +8091522 ") Convert(" 1064.0 ") Convert(" 178.3") Convert(String.Empty) Convert((CDec(Int64.MaxValue) + 1).ToString()) End Sub Private Sub Convert(value As String) Try Dim number As Long = Int64.Parse(value) Console.WriteLine("Converted '{0}' to {1}.", value, number) Catch e As FormatException Console.WriteLine("Unable to convert '{0}'.", value) Catch e As OverflowException Console.WriteLine("'{0}' is out of range.", value) End Try End Sub End Module ' This example displays the following output to the console: ' Converted ' 179032 ' to 179032. ' Converted ' -2041326 ' to -2041326. ' Converted ' +8091522 ' to 8091522. ' Unable to convert ' 1064.0 '. ' Unable to convert ' 178.3'. ' Unable to convert ''. ' '9223372036854775808' is out of range.
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