Int64.Parse Method (String, NumberStyles, IFormatProvider)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function Parse ( _
s As String, _
style As NumberStyles, _
provider As IFormatProvider _
) As Long
public static long Parse(
string s,
NumberStyles style,
IFormatProvider provider
)
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.
Return Value
Type: System.Int64
A 64-bit signed integer equivalent to the number specified in s.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | s is nulla null reference (Nothing in Visual Basic). |
| 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. |
Remarks
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 nulla null reference (Nothing in Visual Basic), the NumberFormatInfo for the current culture is used.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also