次の方法で共有


Convert.ToSingle メソッド

指定した値を単精度浮動小数点数に変換します。

オーバーロードの一覧

指定したブール値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Boolean) As Single

[C#] public static float ToSingle(bool);

[C++] public: static float ToSingle(bool);

[JScript] public static function ToSingle(Boolean) : float;

指定した 8 ビット符号なし整数値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Byte) As Single

[C#] public static float ToSingle(byte);

[C++] public: static float ToSingle(unsigned char);

[JScript] public static function ToSingle(Byte) : float;

このメソッドを呼び出すと、必ず InvalidCastException がスローされます。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Char) As Single

[C#] public static float ToSingle(char);

[C++] public: static float ToSingle(__wchar_t);

[JScript] public static function ToSingle(Char) : float;

このメソッドを呼び出すと、必ず InvalidCastException がスローされます。

[Visual Basic] Overloads Public Shared Function ToSingle(DateTime) As Single

[C#] public static float ToSingle(DateTime);

[C++] public: static float ToSingle(DateTime);

[JScript] public static function ToSingle(DateTime) : float;

指定した Decimal の数値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Decimal) As Single

[C#] public static float ToSingle(decimal);

[C++] public: static float ToSingle(Decimal);

[JScript] public static function ToSingle(Decimal) : float;

指定した倍精度浮動小数点数値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Double) As Single

[C#] public static float ToSingle(double);

[C++] public: static float ToSingle(double);

[JScript] public static function ToSingle(double) : float;

指定した 16 ビット符号付き整数の値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Short) As Single

[C#] public static float ToSingle(short);

[C++] public: static float ToSingle(short);

[JScript] public static function ToSingle(Int16) : float;

指定した 32 ビット符号付き整数の値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Integer) As Single

[C#] public static float ToSingle(int);

[C++] public: static float ToSingle(int);

[JScript] public static function ToSingle(int) : float;

指定した 64 ビット符号付き整数の値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Long) As Single

[C#] public static float ToSingle(long);

[C++] public: static float ToSingle(__int64);

[JScript] public static function ToSingle(long) : float;

指定した Object の値を単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Object) As Single

[C#] public static float ToSingle(object);

[C++] public: static float ToSingle(Object*);

[JScript] public static function ToSingle(Object) : float;

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

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(SByte) As Single

[C#] public static float ToSingle(sbyte);

[C++] public: static float ToSingle(char);

[JScript] public static function ToSingle(SByte) : float;

指定した単精度浮動小数点数を返します。実際の変換処理は実行されません。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(Single) As Single

[C#] public static float ToSingle(float);

[C++] public: static float ToSingle(float);

[JScript] public static function ToSingle(float) : float;

指定した String 形式の数値を、それと等価な単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(String) As Single

[C#] public static float ToSingle(string);

[C++] public: static float ToSingle(String*);

[JScript] public static function ToSingle(String) : float;

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

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(UInt16) As Single

[C#] public static float ToSingle(ushort);

[C++] public: static float ToSingle(unsigned short);

[JScript] public static function ToSingle(UInt16) : float;

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

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(UInt32) As Single

[C#] public static float ToSingle(uint);

[C++] public: static float ToSingle(unsigned int);

[JScript] public static function ToSingle(UInt32) : float;

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

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(UInt64) As Single

[C#] public static float ToSingle(ulong);

[C++] public: static float ToSingle(unsigned __int64);

[JScript] public static function ToSingle(UInt64) : float;

指定したカルチャに固有の書式情報を使用して、指定した Object の値を等価の単精度浮動小数点数に変換します。

[Visual Basic] Overloads Public Shared Function ToSingle(Object, IFormatProvider) As Single

[C#] public static float ToSingle(object, IFormatProvider);

[C++] public: static float ToSingle(Object*, IFormatProvider*);

[JScript] public static function ToSingle(Object, IFormatProvider) : float;

指定したカルチャに固有の書式情報を使用して、指定した String 形式の数値を等価の単精度浮動小数点数に変換します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shared Function ToSingle(String, IFormatProvider) As Single

[C#] public static float ToSingle(string, IFormatProvider);

[C++] public: static float ToSingle(String*, IFormatProvider*);

[JScript] public static function ToSingle(String, IFormatProvider) : float;

使用例

[Visual Basic, C#, C++] IFormatProvider オブジェクトを使用し、 String 形式の Single の値を ToSingle メソッドで変換するコード例を次に示します。

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

 
' Example of the Convert.ToSingle( String ) and 
' Convert.ToSingle( String, IFormatProvider ) methods.
Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic

Module ToSingleProviderDemo

    Dim formatter As String = "{0,-22}{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( )
        GetExceptionType = exceptionType.Substring( _
            exceptionType.LastIndexOf( "."c ) + 1 )
    End Function

    Sub ConvertToSingle( numericStr As String, _
        provider As IFormatProvider )

        Dim defaultValue    As Object
        Dim providerValue   As Object

        ' Convert numericStr to Single without a format provider.
        Try
            defaultValue = Convert.ToSingle( numericStr )
        Catch ex As Exception
            defaultValue = GetExceptionType( ex )
        End Try

        ' Convert numericStr to Single with a format provider.
        Try
            providerValue = Convert.ToSingle( numericStr, provider )
        Catch ex As Exception
            providerValue = GetExceptionType( ex )
        End Try

        Console.WriteLine( formatter, 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( )

        provider.NumberDecimalSeparator = ","
        provider.NumberGroupSeparator = "."
        provider.NumberGroupSizes = New Integer( ) { 3 }

        Console.WriteLine( "This example of" & vbCrLf & _
            "  Convert.ToSingle( String ) and " & vbCrLf & _
            "  Convert.ToSingle( String, IFormatProvider ) " & _
            vbCrLf & "generates the " & _
            "following output when run in the [{0}] culture.", _
            CultureInfo.CurrentCulture.Name )
        Console.WriteLine( vbCrLf & _
            "Several strings are converted to Single values, " & _
            "using " & vbCrLf & "default formatting " & _
            "and a NumberFormatInfo object." & vbCrLf )
        Console.WriteLine( formatter, "String to convert", _
            "Default/exception", "Provider/exception" )
        Console.WriteLine( formatter, "-----------------", _
            "-----------------", "------------------" )

        ' Convert strings, with and without an IFormatProvider.
        ConvertToSingle( "1234567", provider )
        ConvertToSingle( "1234.567", provider )
        ConvertToSingle( "1234,567", provider )
        ConvertToSingle( "12,345.67", provider )
        ConvertToSingle( "12.345,67", provider )
        ConvertToSingle( "1,234,567.89", provider )
        ConvertToSingle( "1.234.567,89", provider )
    End Sub 
End Module 

' This example of
'   Convert.ToSingle( String ) and
'   Convert.ToSingle( String, IFormatProvider )
' generates the following output when run in the [en-US] culture.
' 
' Several strings are converted to Single values, using
' default formatting and a NumberFormatInfo object.
' 
' String to convert     Default/exception   Provider/exception
' -----------------     -----------------   ------------------
' 1234567               1234567             1234567
' 1234.567              1234.567            1234567
' 1234,567              1234567             1234.567
' 12,345.67             12345.67            FormatException
' 12.345,67             FormatException     12345.67
' 1,234,567.89          1234568             FormatException
' 1.234.567,89          FormatException     1234568

[C#] 
// Example of the Convert.ToSingle( String ) and 
// Convert.ToSingle( String, IFormatProvider ) methods.
using System;
using System.Globalization;

class ToSingleProviderDemo
{
    static string formatter = "{0,-22}{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 ConvertToSingle( string numericStr, 
        IFormatProvider provider )
    {
        object defaultValue;
        object providerValue;

        // Convert numericStr to float without a format provider.
        try
        {
            defaultValue = Convert.ToSingle( numericStr );
        }
        catch( Exception ex )
        {
            defaultValue = GetExceptionType( ex );
        }

        // Convert numericStr to float with a format provider.
        try
        {
            providerValue = Convert.ToSingle( numericStr, provider );
        }
        catch( Exception ex )
        {
            providerValue = GetExceptionType( ex );
        }

        Console.WriteLine( formatter, numericStr, defaultValue, 
            providerValue );
    }

    static void Main( )
    {
        // Create a NumberFormatInfo object and set several of its
        // properties that apply to numbers.
        NumberFormatInfo provider = new NumberFormatInfo( );

        provider.NumberDecimalSeparator = ",";
        provider.NumberGroupSeparator = ".";
        provider.NumberGroupSizes = new int[ ] { 3 };

        Console.WriteLine( 
            "This example of\n  Convert.ToSingle( String ) and \n" +
            "  Convert.ToSingle( String, IFormatProvider ) \n" +
            "generates the following output when run in the " +
            "[{0}] culture.", 
            CultureInfo.CurrentCulture.Name );
        Console.WriteLine( "\nSeveral " +
            "strings are converted to float values, using \n" +
            "default formatting and a NumberFormatInfo object.\n");
        Console.WriteLine( formatter, "String to convert", 
            "Default/exception", "Provider/exception" );
        Console.WriteLine( formatter, "-----------------", 
            "-----------------", "------------------" );

        // Convert strings, with and without an IFormatProvider.
        ConvertToSingle( "1234567", provider );
        ConvertToSingle( "1234.567", provider );
        ConvertToSingle( "1234,567", provider );
        ConvertToSingle( "12,345.67", provider );
        ConvertToSingle( "12.345,67", provider );
        ConvertToSingle( "1,234,567.89", provider );
        ConvertToSingle( "1.234.567,89", provider );
    }
}

/*
This example of
  Convert.ToSingle( String ) and
  Convert.ToSingle( String, IFormatProvider )
generates the following output when run in the [en-US] culture.

Several strings are converted to float values, using
default formatting and a NumberFormatInfo object.

String to convert     Default/exception   Provider/exception
-----------------     -----------------   ------------------
1234567               1234567             1234567
1234.567              1234.567            1234567
1234,567              1234567             1234.567
12,345.67             12345.67            FormatException
12.345,67             FormatException     12345.67
1,234,567.89          1234568             FormatException
1.234.567,89          FormatException     1234568
*/

[C++] 
// Example of the Convert::ToSingle( String ) and 
// Convert::ToSingle( String, IFormatProvider ) methods.
#using <mscorlib.dll>
using namespace System;
using namespace System::Globalization;

const __wchar_t* formatter = L"{0,-22}{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 ConvertToSingle( String* numericStr, 
    IFormatProvider* provider )
{
    Object* defaultValue;
    Object* providerValue;

    // Convert numericStr to float without a format provider.
    try
    {
        defaultValue = __box( Convert::ToSingle( numericStr ) );
    }
    catch( Exception* ex )
    {
        defaultValue = GetExceptionType( ex );
    }

    // Convert numericStr to float with a format provider.
    try
    {
        providerValue = __box( 
            Convert::ToSingle( numericStr, provider ) );
    }
    catch( Exception* ex )
    {
        providerValue = GetExceptionType( ex );
    }

    Console::WriteLine( new String( formatter ), numericStr, 
        defaultValue, providerValue );
}

void main( )
{
    // Create a NumberFormatInfo object and set several of its
    // properties that apply to numbers.
    NumberFormatInfo* provider = new NumberFormatInfo( );

    provider->NumberDecimalSeparator = S",";
    provider->NumberGroupSeparator = S".";
    Int32 sizes __gc [] = { 3 };
    provider->NumberGroupSizes = sizes;

    Console::WriteLine( 
        S"This example of\n  Convert::ToSingle( String* ) and \n" 
        S"  Convert::ToSingle( String*, IFormatProvider* ) \n" 
        S"generates the following output when run in the " 
        S"[{0}] culture.", 
        CultureInfo::CurrentCulture->Name );
    Console::WriteLine( S"\nSeveral " 
        S"strings are converted to float values, using \n" 
        S"default formatting and a NumberFormatInfo object.\n");
    Console::WriteLine( new String( formatter ), S"String to convert", 
        S"Default/exception", S"Provider/exception" );
    Console::WriteLine( new String( formatter ), S"-----------------", 
        S"-----------------", S"------------------" );

    // Convert strings, with and without an IFormatProvider.
    ConvertToSingle( S"1234567", provider );
    ConvertToSingle( S"1234.567", provider );
    ConvertToSingle( S"1234,567", provider );
    ConvertToSingle( S"12,345.67", provider );
    ConvertToSingle( S"12.345,67", provider );
    ConvertToSingle( S"1,234,567.89", provider );
    ConvertToSingle( S"1.234.567,89", provider );
}

/*
This example of
  Convert::ToSingle( String* ) and
  Convert::ToSingle( String*, IFormatProvider* )
generates the following output when run in the [en-US] culture.

Several strings are converted to float values, using
default formatting and a NumberFormatInfo object.

String to convert     Default/exception   Provider/exception
-----------------     -----------------   ------------------
1234567               1234567             1234567
1234.567              1234.567            1234567
1234,567              1234567             1234.567
12,345.67             12345.67            FormatException
12.345,67             FormatException     12345.67
1,234,567.89          1234568             FormatException
1.234.567,89          FormatException     1234568
*/

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

参照

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