Parse Method (String, NumberStyles, IFormatProvider)
Collapse the table of content
Expand the table of content

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.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

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.

ExceptionCondition
ArgumentNullException

s is null.

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 null, the NumberFormatInfo for the current culture is used.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft