Int64::Parse Method (String^, IFormatProvider^)

 

Converts the string representation of a number in a specified culture-specific format to its 64-bit signed integer equivalent.

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

public:
static long long Parse(
	String^ s,
	IFormatProvider^ provider
)

Parameters

s
Type: System::String^

A string containing a number to convert.

provider
Type: System::IFormatProvider^

An object 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.

Exception Condition
ArgumentNullException

s is null.

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]

Items in square brackets ([ and ]) are optional, and other items are as follows.

ws

An optional white space.

sign

An optional sign.

digits

A sequence of digits ranging from 0 to 9.

The s parameter is interpreted using the NumberStyles::Integer style. In addition to decimal digits, only leading and trailing spaces together with a leading sign are allowed. To explicitly define the style elements that can be present in s, use the Int64::Parse(String^, NumberStyles, IFormatProvider^) method.

The provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. The provider parameter supplies culture-specific information about the format of s. If provider is null, the NumberFormatInfo for the current culture is used.

The following example is the button click event handler of a Web form. It uses the array returned by the HttpRequest::UserLanguages property to determine the user's locale. It then instantiates a CultureInfo object that corresponds to that locale. The NumberFormatInfo object that belongs to that CultureInfo object is then passed to the Parse(String^, IFormatProvider^) method to convert the user's input to an Int64 value.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: