UInt16.Parse Method (String)
[ 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 to its 16-bit unsigned integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
- Type: System.String
A string that represents the number to convert.
| Exception | Condition |
|---|---|
| ArgumentNullException | s is null. |
| FormatException | s is not in the correct format. |
| OverflowException | s represents a number less than UInt16.MinValue or greater than UInt16.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.
The following example calls the Parse(String) method to convert each element in a string array to an unsigned 16-bit integer.
using System; public class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { string[] values = { "-0", "17", "-12", "185", "66012", "+0", "", null, "16.1", "28.0", "1,034" }; foreach (string value in values) { try { ushort number = UInt16.Parse(value); outputBlock.Text += String.Format("'{0}' --> {1}", value, number) + "\n"; } catch (FormatException) { outputBlock.Text += String.Format("'{0}' --> Bad Format", value) + "\n"; } catch (OverflowException) { outputBlock.Text += String.Format("'{0}' --> OverflowException", value) + "\n"; } catch (ArgumentNullException) { outputBlock.Text += String.Format("'{0}' --> Null", value) + "\n"; } } } } // The example displays the following output: // '-0' --> 0 // '17' --> 17 // '-12' --> OverflowException // '185' --> 185 // '66012' --> OverflowException // '+0' --> 0 // '' --> Bad Format // '' --> Null // '16.1' --> Bad Format // '28.0' --> Bad Format // '1,034' --> Bad Format
Note: