Int64.Parse Method (String, 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 culture-specific format to its 64-bit signed integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Shared Function Parse ( _ s As String, _ provider As IFormatProvider _ ) As Long
Parameters
- s
- Type: System.String
A string containing a number to convert.
- provider
- Type: System.IFormatProvider
An IFormatProvider that supplies culture-specific formatting information about s.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is Nothing. |
| FormatException | s is not in the correct format. |
| OverflowException | s represents a number less than MinValue or greater than MaxValue. |
This overload of the Parse(String, IFormatProvider) method is typically used to convert text that can be formatted in a variety of ways to an Int64 value. For example, it can be used to convert the text entered by a user into an HTML text box to a numeric value.
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 | An optional white space. |
sign | An optional sign. |
digits | A sequence of digits ranging from 0 to 9. |
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.