UInt32::Parse Method (String^)
Converts the string representation of a number to its 32-bit unsigned integer equivalent.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
-
Type:
System::String^
A string representing the number to convert.
| 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. |
Note |
|---|
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.
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
