Convert::ToSByte Method (Object^, IFormatProvider^)
Converts the value of the specified object to an 8-bit signed integer, using the specified culture-specific formatting information.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
public: [CLSCompliantAttribute(false)] static signed char ToSByte( Object^ value, IFormatProvider^ provider )
Parameters
- value
-
Type:
System::Object^
An object that implements the IConvertible interface.
- provider
-
Type:
System::IFormatProvider^
An object that supplies culture-specific formatting information.
Return Value
Type: System::SByteAn 8-bit signed integer that is equivalent to value, or zero if value is null.
| Exception | Condition |
|---|---|
| FormatException | value is not in an appropriate format. |
| InvalidCastException | |
| OverflowException | value represents a number that is less than SByte::MinValue or greater than SByte::MaxValue. |
provider enables the user to specify culture-specific conversion information about the contents of value. For example, if value is a String that represents a number, provider could supply culture-specific information about the notation used to represent that number.
The base types ignore provider; however, the parameter may be used if value is a user-defined type that implements the IConvertible interface.
The following example defines a ByteString class that stores both signed and unsigned bytes as hexadecimal strings along with a field that indicates the sign of the byte. The ByteString class implements the IConvertible interface. Its IConvertible::ToSByte method calls the Parse(String^, IFormatProvider^) method to perform the conversion. If it fails, it throws an OverflowException.
The following example shows how the IConvertible::ToSByte implementation of the ByteString class is called by the Convert::ToSByte(Object^, IFormatProvider^) method.
Available since 8
.NET Framework
Available since 1.1
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