Convert.ToUInt16 Method
Converts a specified value to a 16-bit unsigned integer.
Overload List
Converts the value of the specified Boolean value to the equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Boolean) As UInt16
[C#] public static ushort ToUInt16(bool);
[C++] public: static unsigned short ToUInt16(bool);
[JScript] public static function ToUInt16(Boolean) : UInt16;
Converts the value of the specified 8-bit unsigned integer to the equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Byte) As UInt16
[C#] public static ushort ToUInt16(byte);
[C++] public: static unsigned short ToUInt16(unsigned char);
[JScript] public static function ToUInt16(Byte) : UInt16;
Converts the value of the specified Unicode character to the equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Char) As UInt16
[C#] public static ushort ToUInt16(char);
[C++] public: static unsigned short ToUInt16(__wchar_t);
[JScript] public static function ToUInt16(Char) : UInt16;
Calling this method always throws InvalidCastException. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToUInt16(DateTime) As UInt16
[C#] public static ushort ToUInt16(DateTime);
[C++] public: static unsigned short ToUInt16(DateTime);
[JScript] public static function ToUInt16(DateTime) : UInt16;
Converts the value of the specified Decimal number to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Decimal) As UInt16
[C#] public static ushort ToUInt16(decimal);
[C++] public: static unsigned short ToUInt16(Decimal);
[JScript] public static function ToUInt16(Decimal) : UInt16;
Converts the value of the specified double-precision floating point number to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Double) As UInt16
[C#] public static ushort ToUInt16(double);
[C++] public: static unsigned short ToUInt16(double);
[JScript] public static function ToUInt16(double) : UInt16;
Converts the value of the specified 16-bit signed integer to the equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Short) As UInt16
[C#] public static ushort ToUInt16(short);
[C++] public: static unsigned short ToUInt16(short);
[JScript] public static function ToUInt16(Int16) : UInt16;
Converts the value of the specified 32-bit signed integer to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Integer) As UInt16
[C#] public static ushort ToUInt16(int);
[C++] public: static unsigned short ToUInt16(int);
[JScript] public static function ToUInt16(int) : UInt16;
Converts the value of the specified 64-bit signed integer to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Long) As UInt16
[C#] public static ushort ToUInt16(long);
[C++] public: static unsigned short ToUInt16(__int64);
[JScript] public static function ToUInt16(long) : UInt16;
Converts the value of the specified Object to a 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Object) As UInt16
[C#] public static ushort ToUInt16(object);
[C++] public: static unsigned short ToUInt16(Object*);
[JScript] public static function ToUInt16(Object) : UInt16;
Converts the value of the specified 8-bit signed integer to the equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(SByte) As UInt16
[C#] public static ushort ToUInt16(sbyte);
[C++] public: static unsigned short ToUInt16(char);
[JScript] public static function ToUInt16(SByte) : UInt16;
Converts the value of the specified single-precision floating point number to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(Single) As UInt16
[C#] public static ushort ToUInt16(float);
[C++] public: static unsigned short ToUInt16(float);
[JScript] public static function ToUInt16(float) : UInt16;
Converts the specified String representation of a number to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(String) As UInt16
[C#] public static ushort ToUInt16(string);
[C++] public: static unsigned short ToUInt16(String*);
[JScript] public static function ToUInt16(String) : UInt16;
Returns the specified 16-bit unsigned integer; no actual conversion is performed. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(UInt16) As UInt16
[C#] public static ushort ToUInt16(ushort);
[C++] public: static unsigned short ToUInt16(unsigned short);
[JScript] public static function ToUInt16(UInt16) : UInt16;
Converts the value of the specified 32-bit unsigned integer to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(UInt32) As UInt16
[C#] public static ushort ToUInt16(uint);
[C++] public: static unsigned short ToUInt16(unsigned int);
[JScript] public static function ToUInt16(UInt32) : UInt16;
Converts the value of the specified 64-bit unsigned integer to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(UInt64) As UInt16
[C#] public static ushort ToUInt16(ulong);
[C++] public: static unsigned short ToUInt16(unsigned __int64);
[JScript] public static function ToUInt16(UInt64) : UInt16;
Converts the value of the specified Object to a 16-bit unsigned integer using the specified culture-specific formatting information. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToUInt16(Object, IFormatProvider) As UInt16
[C#] public static ushort ToUInt16(object, IFormatProvider);
[C++] public: static unsigned short ToUInt16(Object*, IFormatProvider*);
[JScript] public static function ToUInt16(Object, IFormatProvider) : UInt16;
Converts the specified String representation of a number to an equivalent 16-bit unsigned 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 ToUInt16(String, IFormatProvider) As UInt16
[C#] public static ushort ToUInt16(string, IFormatProvider);
[C++] public: static unsigned short ToUInt16(String*, IFormatProvider*);
[JScript] public static function ToUInt16(String, IFormatProvider) : UInt16;
Converts the String representation of a number in a specified base to an equivalent 16-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt16(String, Integer) As UInt16
[C#] public static ushort ToUInt16(string, int);
[C++] public: static unsigned short ToUInt16(String*, int);
[JScript] public static function ToUInt16(String, int) : UInt16;
Example
[Visual Basic, C#, C++] The following code example converts String representations of UInt16 (16-bit unsigned integers) with the ToUInt16 method, using an IFormatProvider object.
[Visual Basic, C#, C++] Note This example shows how to use one of the overloaded versions of ToUInt16. For other examples that might be available, see the individual overload topics.
[Visual Basic] ' Example of the Convert.ToUInt16( String ) and ' Convert.ToUInt16( String, IFormatProvider ) methods. Imports System Imports System.Globalization Imports Microsoft.VisualBasic Module ToUInt16ProviderDemo 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 ConvertToUInt16( numericStr As String, _ provider As IFormatProvider ) Dim defaultValue As Object Dim providerValue As Object ' Convert numericStr to UInt16 without a format provider. Try defaultValue = Convert.ToUInt16( numericStr ) Catch ex As Exception defaultValue = GetExceptionType( ex ) End Try ' Convert numericStr to UInt16 with a format provider. Try providerValue = Convert.ToUInt16( 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.PositiveSign = "pos " provider.NegativeSign = "neg " ' These properties do not affect the conversion. ' The input string cannot have decimal and group separators. provider.NumberDecimalSeparator = "." provider.NumberGroupSeparator = "," provider.NumberGroupSizes = New Integer( ) { 3 } Console.WriteLine( "This example of" & vbCrLf & _ " Convert.ToUInt16( String ) and " & vbCrLf & _ " Convert.ToUInt16( String, IFormatProvider ) " & _ vbCrLf & "generates the following output. It " & _ "converts several strings to unsigned " & vbCrLf & _ "Short 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. ConvertToUInt16( "34567", provider ) ConvertToUInt16( "+34567", provider ) ConvertToUInt16( "pos 34567", provider ) ConvertToUInt16( "34567.", provider ) ConvertToUInt16( "34,567", provider ) ConvertToUInt16( "65535", provider ) ConvertToUInt16( "65536", provider ) ConvertToUInt16( "-1", provider ) End Sub End Module ' This example of ' Convert.ToUInt16( String ) and ' Convert.ToUInt16( String, IFormatProvider ) ' generates the following output. It converts several strings to unsigned ' Short values, using default formatting or a NumberFormatInfo object. ' ' String to convert Default/exception Provider/exception ' ----------------- ----------------- ------------------ ' 34567 34567 34567 ' +34567 34567 FormatException ' pos 34567 FormatException 34567 ' 34567. FormatException FormatException ' 34,567 FormatException FormatException ' 65535 65535 65535 ' 65536 OverflowException OverflowException ' -1 OverflowException FormatException [C#] // Example of the Convert.ToUInt16( string ) and // Convert.ToUInt16( string, IFormatProvider ) methods. using System; using System.Globalization; class ToUInt16ProviderDemo { 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 ConvertToUInt16( string numericStr, IFormatProvider provider ) { object defaultValue; object providerValue; // Convert numericStr to UInt16 without a format provider. try { defaultValue = Convert.ToUInt16( numericStr ); } catch( Exception ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to UInt16 with a format provider. try { providerValue = Convert.ToUInt16( 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.NumberGroupSeparator = ","; provider.NumberGroupSizes = new int[ ] { 3 }; Console.WriteLine("This example of\n" + " Convert.ToUInt16( string ) and \n" + " Convert.ToUInt16( string, IFormatProvider ) " + "\ngenerates the following output. It converts " + "several strings to \nushort 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. ConvertToUInt16( "34567", provider ); ConvertToUInt16( "+34567", provider ); ConvertToUInt16( "pos 34567", provider ); ConvertToUInt16( "34567.", provider ); ConvertToUInt16( "34,567", provider ); ConvertToUInt16( "65535", provider ); ConvertToUInt16( "65536", provider ); ConvertToUInt16( "-1", provider ); } } /* This example of Convert.ToUInt16( string ) and Convert.ToUInt16( string, IFormatProvider ) generates the following output. It converts several strings to ushort values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 34567 34567 34567 +34567 34567 FormatException pos 34567 FormatException 34567 34567. FormatException FormatException 34,567 FormatException FormatException 65535 65535 65535 65536 OverflowException OverflowException -1 OverflowException FormatException */ [C++] // Example of the Convert::ToUInt16( String* ) and // Convert::ToUInt16( 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 ConvertToUInt16( String* numericStr, IFormatProvider* provider ) { Object* defaultValue; Object* providerValue; // Convert numericStr to UInt16 without a format provider. try { defaultValue = __box( Convert::ToUInt16( numericStr ) ); } catch( Exception* ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to UInt16 with a format provider. try { providerValue = __box( Convert::ToUInt16( 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->NumberGroupSeparator = S","; Int32 sizes __gc [ ] = { 3 }; provider->NumberGroupSizes = sizes; Console::WriteLine(S"This example of\n" S" Convert::ToUInt16( String* ) and \n" S" Convert::ToUInt16( String*, IFormatProvider* ) " S"\ngenerates the following output. It converts " S"several strings to unsigned \nshort 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. ConvertToUInt16( S"34567", provider ); ConvertToUInt16( S"+34567", provider ); ConvertToUInt16( S"pos 34567", provider ); ConvertToUInt16( S"34567.", provider ); ConvertToUInt16( S"34,567", provider ); ConvertToUInt16( S"65535", provider ); ConvertToUInt16( S"65536", provider ); ConvertToUInt16( S"-1", provider ); } /* This example of Convert::ToUInt16( String* ) and Convert::ToUInt16( String*, IFormatProvider* ) generates the following output. It converts several strings to unsigned short values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 34567 34567 34567 +34567 34567 FormatException pos 34567 FormatException 34567 34567. FormatException FormatException 34,567 FormatException FormatException 65535 65535 65535 65536 OverflowException OverflowException -1 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.
