Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

UInt32::Parse Method (String^)

.NET Framework (current version)
 
clsCompliantAlternativeM:System.Int64.Parse(System.String)

Converts the string representation of a number to its 32-bit unsigned integer equivalent.

This API is not CLS-compliant.

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

C#
C++
F#
VB
Copy 
public:
[CLSCompliantAttribute(false)]
static unsigned int Parse(
	String^ s
)

Parameters

s
Type: System::String^

A string representing the number to convert.

Return Value

Type: System::UInt32

A 32-bit unsigned integer equivalent to the number contained in s.

Exception Condition
ArgumentNullException

The s parameter is null.

FormatException

The s parameter is not of the correct format.

OverflowException

The s parameter represents a number that is less than UInt32::MinValue or greater than UInt32::MaxValue.

The s parameter should be the string representation of a number in the following form.

[ws][sign]digits[ws]

Elements in square brackets ([ and ]) are optional. The following table describes each element.

Element

Description

ws

Optional white space.

sign

An optional sign. Valid sign characters are determined by the NumberFormatInfo::NegativeSign and NumberFormatInfo::PositiveSign properties of the current culture. However, the negative sign symbol can be used only with zero; otherwise, the method throws an OverflowException.

digits

A sequence of digits ranging from 0 to 9. Any leading zeros are ignored.

System_CAPS_noteNote

The string specified by the s parameter is interpreted by using the NumberStyles::Integer style. It cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

The s parameter is parsed by using the formatting information in a System.Globalization::NumberFormatInfo object that is initialized for the current system culture. For more information, see NumberFormatInfo::CurrentInfo. To parse a string by using the formatting information of a specific culture, use the Parse(String^, IFormatProvider^) method.

The following example uses the Parse(String^) method to parse an array of string values.

C#
VB
C++
Copy
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: