Int16.Parse Method (String)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Converts the string representation of a number to its 16-bit signed integer equivalent.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function Parse ( _
s As String _
) As Short
public static short Parse(
string s
)
Parameters
- s
Type: System.String
A string containing a number to convert.
Return Value
Type: System.Int16
A 16-bit signed integer equivalent to the number contained in s.
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | s is nulla null reference (Nothing in Visual Basic). |
FormatException | s is not in the correct format. |
OverflowException | s represents a number less than MinValue or greater than MaxValue. |
Remarks
The s parameter contains a number of the 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. |
digits |
A sequence of digits ranging from 0 to 9. |
The s parameter is interpreted using the NumberStyles.Integer style. In addition to the integer value's 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 Int16.Parse(String, NumberStyles) or the Parse method.
The s parameter is parsed using the formatting information in a NumberFormatInfo object that is 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 Int16.Parse(String, NumberStyles, IFormatProvider) method.
Examples
The following example demonstrates how to convert a string value into a 16-bit signed integer value using the Int16.Parse(String) method. The resulting integer value is then displayed to the console.
Dim value As String
Dim number As Short
value = " 12603 "
Try
number = Short.Parse(value)
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) & vbCrLf
Catch e As FormatException
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.", _
value) & vbCrLf
End Try
value = " 16,054"
Try
number = Short.Parse(value)
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) & vbCrLf
Catch e As FormatException
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.", _
value) & vbCrLf
End Try
value = " -17264"
Try
number = Short.Parse(value)
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) & vbCrLf
Catch e As FormatException
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.", _
value) & vbCrLf
End Try
' The example displays the following output:
' Converted ' 12603 ' to 12603.
' Unable to convert ' 16,054' to a 16-bit signed integer.
' Converted ' -17264' to -17264.
string value;
short number;
value = " 12603 ";
try
{
number = Int16.Parse(value);
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) + "\n";
}
catch (FormatException)
{
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.",
value) + "\n";
}
value = " 16,054";
try
{
number = Int16.Parse(value);
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) + "\n";
}
catch (FormatException)
{
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.",
value) + "\n";
}
value = " -17264";
try
{
number = Int16.Parse(value);
outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) + "\n";
}
catch (FormatException)
{
outputBlock.Text += String.Format("Unable to convert '{0}' to a 16-bit signed integer.",
value) + "\n";
}
// The example displays the following output:
// Converted ' 12603 ' to 12603.
// Unable to convert ' 16,054' to a 16-bit signed integer.
// Converted ' -17264' to -17264.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also