Convert.ToUInt64 Method
.NET Framework 1.1
Converts a specified value to a 64-bit unsigned integer.
Overload List
Converts the value of the specified Boolean value to the equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Boolean) As UInt64
[C#] public static ulong ToUInt64(bool);
[C++] public: static unsigned __int64 ToUInt64(bool);
[JScript] public static function ToUInt64(Boolean) : UInt64;
Converts the value of the specified 8-bit unsigned integer to the equivalent 64-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Byte) As UInt64
[C#] public static ulong ToUInt64(byte);
[C++] public: static unsigned __int64 ToUInt64(unsigned char);
[JScript] public static function ToUInt64(Byte) : UInt64;
Converts the value of the specified Unicode character to the equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Char) As UInt64
[C#] public static ulong ToUInt64(char);
[C++] public: static unsigned __int64 ToUInt64(__wchar_t);
[JScript] public static function ToUInt64(Char) : UInt64;
Calling this method always throws InvalidCastException. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToUInt64(DateTime) As UInt64
[C#] public static ulong ToUInt64(DateTime);
[C++] public: static unsigned __int64 ToUInt64(DateTime);
[JScript] public static function ToUInt64(DateTime) : UInt64;
Converts the value of the specified Decimal number to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Decimal) As UInt64
[C#] public static ulong ToUInt64(decimal);
[C++] public: static unsigned __int64 ToUInt64(Decimal);
[JScript] public static function ToUInt64(Decimal) : UInt64;
Converts the value of the specified double-precision floating point number to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Double) As UInt64
[C#] public static ulong ToUInt64(double);
[C++] public: static unsigned __int64 ToUInt64(double);
[JScript] public static function ToUInt64(double) : UInt64;
Converts the value of the specified 16-bit signed integer to the equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Short) As UInt64
[C#] public static ulong ToUInt64(short);
[C++] public: static unsigned __int64 ToUInt64(short);
[JScript] public static function ToUInt64(Int16) : UInt64;
Converts the value of the specified 32-bit signed integer to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Integer) As UInt64
[C#] public static ulong ToUInt64(int);
[C++] public: static unsigned __int64 ToUInt64(int);
[JScript] public static function ToUInt64(int) : UInt64;
Converts the value of the specified 64-bit signed integer to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Long) As UInt64
[C#] public static ulong ToUInt64(long);
[C++] public: static unsigned __int64 ToUInt64(__int64);
[JScript] public static function ToUInt64(long) : UInt64;
Converts the value of the specified Object to a 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Object) As UInt64
[C#] public static ulong ToUInt64(object);
[C++] public: static unsigned __int64 ToUInt64(Object*);
[JScript] public static function ToUInt64(Object) : UInt64;
Converts the value of the specified 8-bit signed integer to the equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(SByte) As UInt64
[C#] public static ulong ToUInt64(sbyte);
[C++] public: static unsigned __int64 ToUInt64(char);
[JScript] public static function ToUInt64(SByte) : UInt64;
Converts the value of the specified single-precision floating point number to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(Single) As UInt64
[C#] public static ulong ToUInt64(float);
[C++] public: static unsigned __int64 ToUInt64(float);
[JScript] public static function ToUInt64(float) : UInt64;
Converts the specified String representation of a number to an equivalent 64-bit signed integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(String) As UInt64
[C#] public static ulong ToUInt64(string);
[C++] public: static unsigned __int64 ToUInt64(String*);
[JScript] public static function ToUInt64(String) : UInt64;
Converts the value of the specified 16-bit unsigned integer to the equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(UInt16) As UInt64
[C#] public static ulong ToUInt64(ushort);
[C++] public: static unsigned __int64 ToUInt64(unsigned short);
[JScript] public static function ToUInt64(UInt16) : UInt64;
Converts the value of the specified 32-bit unsigned integer to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(UInt32) As UInt64
[C#] public static ulong ToUInt64(uint);
[C++] public: static unsigned __int64 ToUInt64(unsigned int);
[JScript] public static function ToUInt64(UInt32) : UInt64;
Returns the specified 64-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 ToUInt64(UInt64) As UInt64
[C#] public static ulong ToUInt64(ulong);
[C++] public: static unsigned __int64 ToUInt64(unsigned __int64);
[JScript] public static function ToUInt64(UInt64) : UInt64;
Converts the value of the specified Object to a 64-bit unsigned integer using the specified culture-specific formatting information. This method is not CLS-compliant.
[Visual Basic] Overloads Public Shared Function ToUInt64(Object, IFormatProvider) As UInt64
[C#] public static ulong ToUInt64(object, IFormatProvider);
[C++] public: static unsigned __int64 ToUInt64(Object*, IFormatProvider*);
[JScript] public static function ToUInt64(Object, IFormatProvider) : UInt64;
Converts the specified String representation of a number to an equivalent 64-bit unsigned 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 ToUInt64(String, IFormatProvider) As UInt64
[C#] public static ulong ToUInt64(string, IFormatProvider);
[C++] public: static unsigned __int64 ToUInt64(String*, IFormatProvider*);
[JScript] public static function ToUInt64(String, IFormatProvider) : UInt64;
Converts the String representation of a number in a specified base to an equivalent 64-bit unsigned integer. This method is not CLS-compliant.
Supported by the .NET Compact Framework.
[Visual Basic] Overloads Public Shared Function ToUInt64(String, Integer) As UInt64
[C#] public static ulong ToUInt64(string, int);
[C++] public: static unsigned __int64 ToUInt64(String*, int);
[JScript] public static function ToUInt64(String, int) : UInt64;
Example
[Visual Basic, C#, C++] The following code example converts String representations of UInt64 (64-bit unsigned integers) with the ToUInt64 method, using an IFormatProvider object.
[Visual Basic, C#, C++] Note This example shows how to use one of the overloaded versions of ToUInt64. For other examples that might be available, see the individual overload topics.
[Visual Basic] ' Example of the Convert.ToUInt64( String ) and ' Convert.ToUInt64( String, IFormatProvider ) methods. Imports System Imports System.Globalization Imports Microsoft.VisualBasic Module ToUInt64ProviderDemo Dim format As String = "{0,-24}{1,-22}{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 ConvertToUInt64( numericStr As String, _ provider As IFormatProvider ) Dim defaultValue As Object Dim providerValue As Object ' Convert numericStr to UInt64 without a format provider. Try defaultValue = Convert.ToUInt64( numericStr ) Catch ex As Exception defaultValue = GetExceptionType( ex ) End Try ' Convert numericStr to UInt64 with a format provider. Try providerValue = Convert.ToUInt64( 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.ToUInt64( String ) and " & vbCrLf & _ " Convert.ToUInt64( String, IFormatProvider ) " & _ vbCrLf & "generates the following output. It " & _ "converts several strings to unsigned " & vbCrLf & _ "Long 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. ConvertToUInt64( "123456789012", provider ) ConvertToUInt64( "+123456789012", provider ) ConvertToUInt64( "pos 123456789012", provider ) ConvertToUInt64( "123456789012.", provider ) ConvertToUInt64( "123,456,789,012", provider ) ConvertToUInt64( "18446744073709551615", provider ) ConvertToUInt64( "18446744073709551616", provider ) ConvertToUInt64( "-1", provider ) End Sub End Module ' This example of ' Convert.ToUInt64( String ) and ' Convert.ToUInt64( String, IFormatProvider ) ' generates the following output. It converts several strings to unsigned ' Long values, using default formatting or a NumberFormatInfo object. ' ' String to convert Default/exception Provider/exception ' ----------------- ----------------- ------------------ ' 123456789012 123456789012 123456789012 ' +123456789012 123456789012 FormatException ' pos 123456789012 FormatException 123456789012 ' 123456789012. FormatException FormatException ' 123,456,789,012 FormatException FormatException ' 18446744073709551615 18446744073709551615 18446744073709551615 ' 18446744073709551616 OverflowException OverflowException ' -1 OverflowException FormatException [C#] // Example of the Convert.ToUInt64( string ) and // Convert.ToUInt64( string, IFormatProvider ) methods. using System; using System.Globalization; class ToUInt64ProviderDemo { static string format = "{0,-24}{1,-22}{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 ConvertToUInt64( string numericStr, IFormatProvider provider ) { object defaultValue; object providerValue; // Convert numericStr to UInt64 without a format provider. try { defaultValue = Convert.ToUInt64( numericStr ); } catch( Exception ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to UInt64 with a format provider. try { providerValue = Convert.ToUInt64( 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.ToUInt64( string ) and \n" + " Convert.ToUInt64( string, IFormatProvider ) " + "\ngenerates the following output. It converts " + "several strings to \nulong 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. ConvertToUInt64( "123456789012", provider ); ConvertToUInt64( "+123456789012", provider ); ConvertToUInt64( "pos 123456789012", provider ); ConvertToUInt64( "123456789012.", provider ); ConvertToUInt64( "123,456,789,012", provider ); ConvertToUInt64( "18446744073709551615", provider ); ConvertToUInt64( "18446744073709551616", provider ); ConvertToUInt64( "-1", provider ); } } /* This example of Convert.ToUInt64( string ) and Convert.ToUInt64( string, IFormatProvider ) generates the following output. It converts several strings to ulong values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 123456789012 123456789012 123456789012 +123456789012 123456789012 FormatException pos 123456789012 FormatException 123456789012 123456789012. FormatException FormatException 123,456,789,012 FormatException FormatException 18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551616 OverflowException OverflowException -1 OverflowException FormatException */ [C++] // Example of the Convert::ToUInt64( String* ) and // Convert::ToUInt64( String*, IFormatProvider* ) methods. #using <mscorlib.dll> using namespace System; using namespace System::Globalization; const __wchar_t* protoFmt = L"{0,-24}{1,-22}{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 ConvertToUInt64( String* numericStr, IFormatProvider* provider ) { Object* defaultValue; Object* providerValue; // Convert numericStr to UInt64 without a format provider. try { defaultValue = __box( Convert::ToUInt64( numericStr ) ); } catch( Exception* ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to UInt64 with a format provider. try { providerValue = __box( Convert::ToUInt64( 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::ToUInt64( String* ) and \n" S" Convert::ToUInt64( String*, IFormatProvider* ) " S"\ngenerates the following output. It converts " S"several strings to unsigned \n__int64 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. ConvertToUInt64( S"123456789012", provider ); ConvertToUInt64( S"+123456789012", provider ); ConvertToUInt64( S"pos 123456789012", provider ); ConvertToUInt64( S"123456789012.", provider ); ConvertToUInt64( S"123,456,789,012", provider ); ConvertToUInt64( S"18446744073709551615", provider ); ConvertToUInt64( S"18446744073709551616", provider ); ConvertToUInt64( S"-1", provider ); } /* This example of Convert::ToUInt64( String* ) and Convert::ToUInt64( String*, IFormatProvider* ) generates the following output. It converts several strings to unsigned __int64 values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 123456789012 123456789012 123456789012 +123456789012 123456789012 FormatException pos 123456789012 FormatException 123456789012 123456789012. FormatException FormatException 123,456,789,012 FormatException FormatException 18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551616 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.
