Int64.Parse Method (String, NumberStyles, IFormatProvider)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Shared Function Parse ( _ s As String, _ style As NumberStyles, _ provider As IFormatProvider _ ) As Long
Parameters
- s
- Type: System.String
A string containing a number to convert.
- style
- Type: System.Globalization.NumberStyles
A bitwise combination of NumberStyles values that indicates the permitted format of s. A typical value to specify is Integer.
- provider
- Type: System.IFormatProvider
An IFormatProvider that supplies culture-specific formatting information about s.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is Nothing. |
| ArgumentException | style is not a NumberStyles value. -or- style is not a combination of AllowHexSpecifier and HexNumber values. |
| FormatException | s is not in a format compliant with style. |
| OverflowException | s represents a number less than MinValue or greater than MaxValue. |
The s parameter contains a number of the form:
[ws][sign]digits[ws]
Or, if style includes AllowHexSpecifier:
[ws]hexdigits[ws]
Elements in square brackets ([ and ]) are optional. The following table describes each element.
Element | Description |
|---|---|
ws | Optional white space if permitted by style. |
sign | An optional sign. |
digits | A sequence of digits from 0 through 9. |
hexdigits | A sequence of hexadecimal digits from 0 through f, or 0 through F. |
The provider parameter is an IFormatProvider that obtains a NumberFormatInfo object. The NumberFormatInfo provides culture-specific information about the format of s. If provider is Nothing, the NumberFormatInfo for the current culture is used.