Convert.ToUInt64 メソッド

2008-03-28

指定した値を 64 ビット符号なし整数に変換します。

オーバーロードの一覧

指定した Boolean 値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 8 ビット符号なし整数の値を等価の 64 ビット符号付き整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した Unicode 文字の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

このメソッドを呼び出すと、必ず InvalidCastException がスローされます。このメソッドは、CLS と互換性がありません。

[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;

指定した Decimal 数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した倍精度浮動小数点数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 64 ビット符号付き整数の値を等価の 16 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 32 ビット符号付き整数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 64 ビット符号付き整数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した Object の値を 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 64 ビット符号付き整数の値を等価の 8 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した単精度浮動小数点数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した String 形式の数値を、それと等価な 64 ビット符号付き整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 16 ビット符号なし整数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 32 ビット符号なし整数の値を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した 64 ビット符号なし整数が返されます。実際の変換は行われません。このメソッドは、CLS と互換性がありません。

.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;

カルチャに固有の指定した書式情報を使用して、指定した Object の値を 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

[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;

指定したカルチャに固有の書式情報を使用して、指定した String 形式の数値を、それと等価な 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

指定した基数での数値の String 形式を等価の 64 ビット符号なし整数に変換します。このメソッドは、CLS と互換性がありません。

.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;

使用例

[Visual Basic, C#, C++] IFormatProvider オブジェクトを使用し、 String 形式の UInt64 (64 ビット符号なし整数) を ToUInt64 メソッドで変換するコード例を次に示します。

[Visual Basic, C#, C++] メモここでは、ToUInt64 のオーバーロード形式のうちの 1 つだけについて、使用例を示します。その他の例については、各オーバーロード形式のトピックを参照してください。

 
' 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] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

参照

Convert クラス | Convert メンバ | System 名前空間

次の方法で共有

Convert.ToUInt64 メソッド

オーバーロードの一覧

使用例

参照

その他のリソース