IConvertible インターフェイス

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

重要

この API は CLS 準拠ではありません。

実装参照または値型の値を、値がそれと同等である共通言語ランタイム型に変換するメソッドを定義します。

C#

[System.CLSCompliant(false)]
public interface IConvertible

C#

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
public interface IConvertible

派生

System.Boolean

System.Byte

System.Char

System.DateTime

System.DBNull

System.Decimal

System.Double

System.Enum

System.Int16

System.Int32

System.Int64

System.SByte

System.Single

System.String

System.UInt16

System.UInt32

System.UInt64

属性

CLSCompliantAttribute ComVisibleAttribute

例

次のコード サンプルは、複素数クラスのIConvertible実装を示しています。これにより、最初に a としてDoubleキャストし、そのDoubleクラスの静的Convertメンバーを呼び出します。

C#

using System;

namespace ConsoleApplication2
{

    /// Class that implements IConvertible
    class Complex : IConvertible
    {
        double	x;
        double	y;

        public Complex(double x, double y)
        {
            this.x = x;
            this.y = y;
        }

        public TypeCode GetTypeCode()
        {
            return TypeCode.Object;
        }

        bool IConvertible.ToBoolean(IFormatProvider provider)
        {
            if(	(x != 0.0) || (y != 0.0) )
                return true;
            else
                return false;
        }

        double GetDoubleValue()
        {
            return Math.Sqrt(x*x + y*y);
        }

        byte IConvertible.ToByte(IFormatProvider provider)
        {
            return Convert.ToByte(GetDoubleValue());
        }

        char IConvertible.ToChar(IFormatProvider provider)
        {
            return Convert.ToChar(GetDoubleValue());
        }

        DateTime IConvertible.ToDateTime(IFormatProvider provider)
        {
            return Convert.ToDateTime(GetDoubleValue());
        }

        decimal IConvertible.ToDecimal(IFormatProvider provider)
        {
            return Convert.ToDecimal(GetDoubleValue());
        }

        double IConvertible.ToDouble(IFormatProvider provider)
        {
            return GetDoubleValue();
        }

        short IConvertible.ToInt16(IFormatProvider provider)
        {
            return Convert.ToInt16(GetDoubleValue());
        }

        int IConvertible.ToInt32(IFormatProvider provider)
        {
            return Convert.ToInt32(GetDoubleValue());
        }

        long IConvertible.ToInt64(IFormatProvider provider)
        {
            return Convert.ToInt64(GetDoubleValue());
        }

        sbyte IConvertible.ToSByte(IFormatProvider provider)
        {
            return Convert.ToSByte(GetDoubleValue());
        }

        float IConvertible.ToSingle(IFormatProvider provider)
        {
            return Convert.ToSingle(GetDoubleValue());
        }

        string IConvertible.ToString(IFormatProvider provider)
        {
            return String.Format("({0}, {1})", x, y);
        }

        object IConvertible.ToType(Type conversionType, IFormatProvider provider)
        {
            return Convert.ChangeType(GetDoubleValue(),conversionType);
        }

        ushort IConvertible.ToUInt16(IFormatProvider provider)
        {
            return Convert.ToUInt16(GetDoubleValue());
        }

        uint IConvertible.ToUInt32(IFormatProvider provider)
        {
            return Convert.ToUInt32(GetDoubleValue());
        }

        ulong IConvertible.ToUInt64(IFormatProvider provider)
        {
            return Convert.ToUInt64(GetDoubleValue());
        }
    }

    /// <summary>
    /// Summary description for Class1.
    /// </summary>
    class Class1
    {
        static void Main(string[] args)
        {

            Complex		testComplex = new Complex(4,7);

            WriteObjectInfo(testComplex);
            WriteObjectInfo(Convert.ToBoolean(testComplex));
            WriteObjectInfo(Convert.ToDecimal(testComplex));
            WriteObjectInfo(Convert.ToString(testComplex));
        }

        static void WriteObjectInfo(object testObject)
        {
            TypeCode	typeCode = Type.GetTypeCode( testObject.GetType() );

            switch( typeCode )
            {
                case TypeCode.Boolean:
                    Console.WriteLine("Boolean: {0}", testObject);
                    break;

                case TypeCode.Double:
                    Console.WriteLine("Double: {0}", testObject);
                    break;
                                
                default:
                    Console.WriteLine("{0}: {1}", typeCode.ToString(), testObject);
                    break;
            }
        }
    }
}

注釈

このインターフェイスは、実装型のインスタンスの値を、同等の値を持つ共通言語ランタイム型に変換するメソッドを提供します。 共通言語ランタイムの型はBoolean、, , SByte, Byte, Int16, , , UInt16, Int32, DoubleSingleInt64DecimalUInt32UInt64, DateTime, , .StringChar

共通言語ランタイム型への意味のある変換がない場合は、特定のインターフェイス メソッドの実装によってスローされます InvalidCastException。 たとえば、このインターフェイスがブール型に実装されている場合、ブール型と同等の意味DateTimeがないため、メソッドのToDateTime実装によって例外がスローされます。

共通言語ランタイムは、通常、クラスを IConvertible 介してインターフェイスを Convert 公開します。 共通言語ランタイムは、明示的なインターフェイス実装で内部的にインターフェイスを使用 IConvertible して、クラスと基本的な共通言語ランタイム型の変換を Convert サポートするために使用されるコードを簡略化します。

インターフェイスにIConvertible加えて、.NET Frameworkには、ユーザー定義データ型を他のデータ型に変換するための型コンバーターと呼ばれるクラスが用意されています。 詳細については、「 一般化された型変換 」トピックを参照してください。

注意 (実装者)

インターフェイスをIConvertible実装する場合、パラメーターが実装型のインスタンスであり、パラメーターが共通言語ランタイム型Typeの場合Object、実装はメソッドによってChangeType(Object, Type)自動的に呼び出されます。

ほとんどの変換メソッドには、現在のカルチャ (CurrentCulture) または特定のカルチャを表す型IFormatProviderのパラメーターがあります。 ほとんどの場合、 IConvertible 基本型の実装では、このパラメーターは無視されます。 ただし、コードで使用するかどうかを選択できます。

メソッド

GetTypeCode()	インスタンスの TypeCode を返します。
ToBoolean(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価のブール値に変換します。
ToByte(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 8 ビット符号なし整数に変換します。
ToChar(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の Unicode 文字に変換します。
ToDateTime(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の DateTime に変換します。
ToDecimal(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の Decimal 数に変換します。
ToDouble(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の倍精度浮動小数点数に変換します。
ToInt16(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 16 ビット符号付き整数に変換します。
ToInt32(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 32 ビット符号付き整数に変換します。
ToInt64(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 64 ビット符号付き整数に変換します。
ToSByte(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 8 ビット符号付き整数に変換します。
ToSingle(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の単精度浮動小数点数に変換します。
ToString(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の String に変換します。
ToType(Type, IFormatProvider)	指定したカルチャ固有の書式情報を使用して、インスタンスの値を、その値と等価な値を保持した指定の Object の Type に変換します。
ToUInt16(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 16 ビット符号なし整数に変換します。
ToUInt32(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 32 ビット符号なし整数に変換します。
ToUInt64(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、指定したインスタンスの値を等価の 64 ビット符号なし整数に変換します。

適用対象

こちらもご覧ください

• .NET Framework における型変換