Article
11/18/2011

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.

Partager via