Convert.ToSByte Method
Converts a specified value to an 8-bit signed integer.
Overload List
Converts the value of the specified Boolean value to the equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Boolean) As SByte
[C#] public static sbyte ToSByte(bool);
[C++] public: static char ToSByte(bool);
[JScript] public static function ToSByte(Boolean) : SByte;
Converts the value of the specified 8-bit unsigned integer to the equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Byte) As SByte
[C#] public static sbyte ToSByte(byte);
[C++] public: static char ToSByte(unsigned char);
[JScript] public static function ToSByte(Byte) : SByte;
Converts the value of the specified Unicode character to the equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Char) As SByte
[C#] public static sbyte ToSByte(char);
[C++] public: static char ToSByte(__wchar_t);
[JScript] public static function ToSByte(Char) : SByte;
Calling this method always throws InvalidCastException. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToSByte(DateTime) As SByte
[C#] public static sbyte ToSByte(DateTime);
[C++] public: static char ToSByte(DateTime);
[JScript] public static function ToSByte(DateTime) : SByte;
Converts the value of the specified Decimal number to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Decimal) As SByte
[C#] public static sbyte ToSByte(decimal);
[C++] public: static char ToSByte(Decimal);
[JScript] public static function ToSByte(Decimal) : SByte;
Converts the value of the specified double-precision floating point number to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Double) As SByte
[C#] public static sbyte ToSByte(double);
[C++] public: static char ToSByte(double);
[JScript] public static function ToSByte(double) : SByte;
Converts the value of the specified 16-bit signed integer to the equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Short) As SByte
[C#] public static sbyte ToSByte(short);
[C++] public: static char ToSByte(short);
[JScript] public static function ToSByte(Int16) : SByte;
Converts the value of the specified 32-bit signed integer to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Integer) As SByte
[C#] public static sbyte ToSByte(int);
[C++] public: static char ToSByte(int);
[JScript] public static function ToSByte(int) : SByte;
Converts the value of the specified 64-bit signed integer to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Long) As SByte
[C#] public static sbyte ToSByte(long);
[C++] public: static char ToSByte(__int64);
[JScript] public static function ToSByte(long) : SByte;
Converts the value of the specified Object to an 8-bit signed integer. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToSByte(Object) As SByte
[C#] public static sbyte ToSByte(object);
[C++] public: static char ToSByte(Object*);
[JScript] public static function ToSByte(Object) : SByte;
Returns the specified 8-bit signed integer; no actual conversion is performed. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(SByte) As SByte
[C#] public static sbyte ToSByte(sbyte);
[C++] public: static char ToSByte(char);
[JScript] public static function ToSByte(SByte) : SByte;
Converts the value of the specified single-precision floating point number to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Single) As SByte
[C#] public static sbyte ToSByte(float);
[C++] public: static char ToSByte(float);
[JScript] public static function ToSByte(float) : SByte;
Converts the specified String representation of a number to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(String) As SByte
[C#] public static sbyte ToSByte(string);
[C++] public: static char ToSByte(String*);
[JScript] public static function ToSByte(String) : SByte;
Converts the value of the specified 16-bit unsigned integer to the equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(UInt16) As SByte
[C#] public static sbyte ToSByte(ushort);
[C++] public: static char ToSByte(unsigned short);
[JScript] public static function ToSByte(UInt16) : SByte;
Converts the value of the specified 32-bit unsigned integer to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(UInt32) As SByte
[C#] public static sbyte ToSByte(uint);
[C++] public: static char ToSByte(unsigned int);
[JScript] public static function ToSByte(UInt32) : SByte;
Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(UInt64) As SByte
[C#] public static sbyte ToSByte(ulong);
[C++] public: static char ToSByte(unsigned __int64);
[JScript] public static function ToSByte(UInt64) : SByte;
Converts the value of the specified Object to an 8-bit signed integer using the specified culture-specific formatting information. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(Object, IFormatProvider) As SByte
[C#] public static sbyte ToSByte(object, IFormatProvider);
[C++] public: static char ToSByte(Object*, IFormatProvider*);
[JScript] public static function ToSByte(Object, IFormatProvider) : SByte;
Converts the specified String representation of a number to an equivalent 8-bit signed integer using specified culture-specific formatting information. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(String, IFormatProvider) As SByte
[C#] public static sbyte ToSByte(string, IFormatProvider);
[C++] public: static char ToSByte(String*, IFormatProvider*);
[JScript] public static function ToSByte(String, IFormatProvider) : SByte;
Converts the String representation of a number in a specified base to an equivalent 8-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToSByte(String, Integer) As SByte
[C#] public static sbyte ToSByte(string, int);
[C++] public: static char ToSByte(String*, int);
[JScript] public static function ToSByte(String, int) : SByte;
Example
[Visual Basic, C#, C++] The following code example converts String representations of SByte (signed byte) values with the ToSByte method, using an IFormatProvider object.
[Visual Basic, C#, C++] Note This example shows how to use one of the overloaded versions of ToSByte. For other examples that might be available, see the individual overload topics.
[Visual Basic] ' Example of the Convert.ToSByte( String ) and ' Convert.ToSByte( String, IFormatProvider ) methods. Imports System Imports System.Globalization Imports Microsoft.VisualBasic Module ToSByteProviderDemo Dim format As String = "{0,-20}{1,-20}{2}" ' Get the exception type name; remove the namespace prefix. Function GetExceptionType( ex As Exception ) As String Dim exceptionType As String = ex.GetType( ).ToString( ) Return exceptionType.Substring( _ exceptionType.LastIndexOf( "."c ) + 1 ) End Function Sub ConvertToSByte( numericStr As String, _ provider As IFormatProvider ) Dim defaultValue As Object Dim providerValue As Object ' Convert numericStr to SByte without a format provider. Try defaultValue = Convert.ToSByte( numericStr ) Catch ex As Exception defaultValue = GetExceptionType( ex ) End Try ' Convert numericStr to SByte with a format provider. Try providerValue = Convert.ToSByte( numericStr, provider ) Catch ex As Exception providerValue = GetExceptionType( ex ) End Try Console.WriteLine( format, numericStr, _ defaultValue, providerValue ) End Sub Sub Main( ) ' Create a NumberFormatInfo object and set several of its ' properties that apply to numbers. Dim provider As NumberFormatInfo = new NumberFormatInfo( ) ' These properties affect the conversion. provider.NegativeSign = "neg " provider.PositiveSign = "pos " ' These properties do not affect the conversion. ' The input string cannot have decimal and group separators. provider.NumberDecimalSeparator = "." provider.NumberNegativePattern = 0 Console.WriteLine( "This example of" & vbCrLf & _ " Convert.ToSByte( String ) and " & vbCrLf & _ " Convert.ToSByte( String, IFormatProvider ) " & _ vbCrLf & "generates the following output. It " & _ "converts several strings to " & vbCrLf & "SByte " & _ "values, using default formatting " & _ "or a NumberFormatInfo object." & vbCrLf ) Console.WriteLine( format, "String to convert", _ "Default/exception", "Provider/exception" ) Console.WriteLine( format, "-----------------", _ "-----------------", "------------------" ) ' Convert strings, with and without an IFormatProvider. ConvertToSByte( "123", provider ) ConvertToSByte( "+123", provider ) ConvertToSByte( "pos 123", provider ) ConvertToSByte( "-123", provider ) ConvertToSByte( "neg 123", provider ) ConvertToSByte( "123.", provider ) ConvertToSByte( "(123)", provider ) ConvertToSByte( "128", provider ) ConvertToSByte( "-129", provider ) End Sub End Module ' This example of ' Convert.ToSByte( String ) and ' Convert.ToSByte( String, IFormatProvider ) ' generates the following output. It converts several strings to ' SByte values, using default formatting or a NumberFormatInfo object. ' ' String to convert Default/exception Provider/exception ' ----------------- ----------------- ------------------ ' 123 123 123 ' +123 123 FormatException ' pos 123 FormatException 123 ' -123 -123 FormatException ' neg 123 FormatException -123 ' 123. FormatException FormatException ' (123) FormatException FormatException ' 128 OverflowException OverflowException ' -129 OverflowException FormatException [C#] // Example of the Convert.ToSByte( string ) and // Convert.ToSByte( string, IFormatProvider ) methods. using System; using System.Globalization; class ToSByteProviderDemo { static string format = "{0,-20}{1,-20}{2}"; // Get the exception type name; remove the namespace prefix. static string GetExceptionType( Exception ex ) { string exceptionType = ex.GetType( ).ToString( ); return exceptionType.Substring( exceptionType.LastIndexOf( '.' ) + 1 ); } static void ConvertToSByte( string numericStr, IFormatProvider provider ) { object defaultValue; object providerValue; // Convert numericStr to SByte without a format provider. try { defaultValue = Convert.ToSByte( numericStr ); } catch( Exception ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to SByte with a format provider. try { providerValue = Convert.ToSByte( numericStr, provider ); } catch( Exception ex ) { providerValue = GetExceptionType( ex ); } Console.WriteLine( format, numericStr, defaultValue, providerValue ); } public static void Main( ) { // Create a NumberFormatInfo object and set several of its // properties that apply to numbers. NumberFormatInfo provider = new NumberFormatInfo(); // These properties affect the conversion. provider.NegativeSign = "neg "; provider.PositiveSign = "pos "; // These properties do not affect the conversion. // The input string cannot have decimal and group separators. provider.NumberDecimalSeparator = "."; provider.NumberNegativePattern = 0; Console.WriteLine("This example of\n" + " Convert.ToSByte( string ) and \n" + " Convert.ToSByte( string, IFormatProvider ) " + "\ngenerates the following output. It converts " + "several strings to \nSByte values, using " + "default formatting or a NumberFormatInfo object.\n" ); Console.WriteLine( format, "String to convert", "Default/exception", "Provider/exception" ); Console.WriteLine( format, "-----------------", "-----------------", "------------------" ); // Convert strings, with and without an IFormatProvider. ConvertToSByte( "123", provider ); ConvertToSByte( "+123", provider ); ConvertToSByte( "pos 123", provider ); ConvertToSByte( "-123", provider ); ConvertToSByte( "neg 123", provider ); ConvertToSByte( "123.", provider ); ConvertToSByte( "(123)", provider ); ConvertToSByte( "128", provider ); ConvertToSByte( "-129", provider ); } } /* This example of Convert.ToSByte( string ) and Convert.ToSByte( string, IFormatProvider ) generates the following output. It converts several strings to SByte values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 123 123 123 +123 123 FormatException pos 123 FormatException 123 -123 -123 FormatException neg 123 FormatException -123 123. FormatException FormatException (123) FormatException FormatException 128 OverflowException OverflowException -129 OverflowException FormatException */ [C++] // Example of the Convert::ToSByte( String* ) and // Convert::ToSByte( String*, IFormatProvider* ) methods. #using <mscorlib.dll> using namespace System; using namespace System::Globalization; const __wchar_t* protoFmt = L"{0,-20}{1,-20}{2}" ; // Get the exception type name; remove the namespace prefix. String* GetExceptionType( Exception* ex ) { String* exceptionType = ex->GetType( )->ToString( ); return exceptionType->Substring( exceptionType->LastIndexOf( '.' ) + 1 ); } void ConvertToSByte( String* numericStr, IFormatProvider* provider ) { Object* defaultValue; Object* providerValue; // Convert numericStr to SByte without a format provider. try { defaultValue = __box( Convert::ToSByte( numericStr ) ); } catch( Exception* ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to SByte with a format provider. try { providerValue = __box( Convert::ToSByte( numericStr, provider ) ); } catch( Exception* ex ) { providerValue = GetExceptionType( ex ); } Console::WriteLine( new String( protoFmt ), numericStr, defaultValue, providerValue ); } void main( ) { // Create a NumberFormatInfo object and set several of its // properties that apply to numbers. NumberFormatInfo* provider = new NumberFormatInfo( ); // These properties affect the conversion. provider->NegativeSign = S"neg "; provider->PositiveSign = S"pos "; // These properties do not affect the conversion. // The input string cannot have decimal and group separators. provider->NumberDecimalSeparator = S"."; provider->NumberNegativePattern = 0; Console::WriteLine(S"This example of\n" S" Convert::ToSByte( String* ) and \n" S" Convert::ToSByte( String*, IFormatProvider* ) " S"\ngenerates the following output. It converts " S"several strings to \nSByte values, using " S"default formatting or a NumberFormatInfo object.\n" ); Console::WriteLine( new String( protoFmt ), S"String to convert", S"Default/exception", S"Provider/exception" ); Console::WriteLine( new String( protoFmt ), S"-----------------", S"-----------------", S"------------------" ); // Convert strings, with and without an IFormatProvider. ConvertToSByte( S"123", provider ); ConvertToSByte( S"+123", provider ); ConvertToSByte( S"pos 123", provider ); ConvertToSByte( S"-123", provider ); ConvertToSByte( S"neg 123", provider ); ConvertToSByte( S"123.", provider ); ConvertToSByte( S"(123)", provider ); ConvertToSByte( S"128", provider ); ConvertToSByte( S"-129", provider ); } /* This example of Convert::ToSByte( String* ) and Convert::ToSByte( String*, IFormatProvider* ) generates the following output. It converts several strings to SByte values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 123 123 123 +123 123 FormatException pos 123 FormatException 123 -123 -123 FormatException neg 123 FormatException -123 123. FormatException FormatException (123) FormatException FormatException 128 OverflowException OverflowException -129 OverflowException FormatException */
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button 
in the upper-left corner of the page.
