Int16.TryParse Method (String, Int16%)
[ 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 signed integer equivalent. A return value indicates whether the conversion succeeded or failed.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Shared Function TryParse ( _ s As String, _ <OutAttribute> ByRef result As Short _ ) As Boolean
Parameters
- s
- Type: System.String
A string containing a number to convert.
- result
- Type:
System.Int16
%
When this method returns, contains the 16-bit signed integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is Nothing, is not of the correct format, or represents a number less than MinValue or greater than MaxValue. This parameter is passed uninitialized.
The Int16.TryParse(String, Int16) method differs from the Int16.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed Int16 value. It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.
The s parameter should be the string representation of a number in 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 the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) 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.
This overload of the TryParse method interprets all digits in the s parameter as decimal digits. To parse the string representation of a hexadecimal number, call the Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) overload.
The following example calls the Int16.TryParse(String, Int16)method with a number of different string values.
Module Example Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock) TryToParse(outputBlock, Nothing) TryToParse(outputBlock, "16051") TryToParse(outputBlock, "9432.0") TryToParse(outputBlock, "16,667") TryToParse(outputBlock, " -322 ") TryToParse(outputBlock, "+4302") TryToParse(outputBlock, "(100)") TryToParse(outputBlock, "01FA") End Sub Private Sub TryToParse(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal value As String) Dim number As Int16 Dim result As Boolean = Int16.TryParse(value, number) If result Then outputBlock.Text += String.Format("Converted '{0}' to {1}.", value, number) & vbCrLf Else If value Is Nothing Then value = "" outputBlock.Text += String.Format("Attempted conversion of '{0}' failed.", value) & vbCrLf End If End Sub End Module ' The example displays the following output: ' Attempted conversion of '' failed. ' Converted '16051' to 16051. ' Attempted conversion of '9432.0' failed. ' Attempted conversion of '16,667' failed. ' Converted ' -322 ' to -322. ' Converted '+4302' to 4302. ' Attempted conversion of '(100)' failed. ' Attempted conversion of '01FA' failed.