SByte::TryParse Method (String^, SByte%)
Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
public: [CLSCompliantAttribute(false)] static bool TryParse( String^ s, [OutAttribute] signed char% result )
Parameters
- s
-
Type:
System::String^
A string that contains a number to convert.
- result
-
Type:
System::SByte%
When this method returns, contains the 8-bit signed integer value that is 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 null or String::Empty, is not in the correct format, or represents a number that is less than MinValue or greater than MaxValue. This parameter is passed uninitialized; any value originally supplied in result will be overwritten.
The SByte::TryParse(String^, SByte%) method is like the SByte::Parse(String^) method, except that it does not throw an exception if the conversion fails. This method eliminates the need to use exception handling to test for a FormatException if value is invalid and cannot be successfully parsed.
The s parameter should be the string representation of a decimal 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. |
digits | A sequence of decimal digits ranging from 0 to 9. |
 Note |
|---|
The string specified by the value parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion. |
The s parameter is interpreted by using the NumberStyles::Integer style. In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. To explicitly define the style elements with the culture-specific formatting information that can be present in value, call the TryParse(String^, NumberStyles, IFormatProvider^, SByte%) method.
The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current culture. For more information, see NumberFormatInfo::CurrentInfo.
This overload interprets all digits in the value parameter as decimal digits. To parse the string representation of a hexadecimal number, call the TryParse(String^, NumberStyles, IFormatProvider^, SByte%) overload instead.
Available since 8
.NET Framework
Available since 2.0
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