Int32.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 32-bit signed integer equivalent.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- s
- Type: System.String
A string containing a number to convert.
| 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. |
The s parameter contains a number of the form:
[ws][sign]digits[ws]
Items in square brackets ([ and ]) are optional. The following table describes each element.
Element | Description |
|---|---|
ws | 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 either the Int32.Parse(String, NumberStyles) or the Int32.Parse(String, NumberStyles, IFormatProvider) method.
The s parameter is parsed using the formatting information in a NumberFormatInfo object initialized for the current system culture. For more information, see CurrentInfo. To parse a string using the formatting information of some other culture, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.
The following example demonstrates how to convert a string value into a 32-bit signed integer value using the Int32.Parse(String) method. It then displays the resulting integer value.
using System; public class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { Convert(outputBlock, " 179 "); Convert(outputBlock, " -204 "); Convert(outputBlock, " +809 "); Convert(outputBlock, " 178.3"); } private static void Convert(System.Windows.Controls.TextBlock outputBlock, string value) { try { int number = Int32.Parse(value); outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) + "\n"; } catch (FormatException) { outputBlock.Text += String.Format("Unable to convert '{0}'.", value) + "\n"; } } } // This example displays the following output: // Converted ' 179 ' to 179. // Converted ' -204 ' to -204. // Converted ' +809 ' to 809. // Unable to convert ' 178.3'.