Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

IConvertible-Schnittstelle

.NET Framework 2.0

Definiert Methoden für die Konvertierung des Implementierungsverweis- oder -werttyps in einen Typ der Common Language Runtime mit einem entsprechenden Wert.

 

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

C#
C++
VB
Kopieren 
[ComVisibleAttribute(true)] 
[CLSCompliantAttribute(false)] 
public interface IConvertible
J#
Kopieren 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute CLSCompliantAttribute(false) */ 
public interface IConvertible
JScript
Kopieren 
ComVisibleAttribute(true) 
CLSCompliantAttribute(false) 
public interface IConvertible

Diese Schnittstelle stellt Methoden für die Konvertierung des Werts einer Instanz eines Implementierungstyps in einen Typ der Common Language Runtime mit einem entsprechenden Wert bereit. Die Typen der Common Language Runtime sind Boolean, SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, Decimal, DateTime, Char und String.

Wenn keine sinnvolle Konvertierung in einen Typ der Common Language Runtime möglich ist, löst die Implementierung einer bestimmten Schnittstellenmethode eine InvalidCastException aus. Wenn z. B. diese Schnittstelle für einen booleschen Typ implementiert ist, löst die Implementierung der ToDateTime-Methode eine Ausnahme aus, da es keine sinnvolle DateTime-Entsprechung zu einem booleschen Typ gibt.

Die Common Language Runtime macht die IConvertible-Schnittstelle i. d. R. über die Convert-Klasse verfügbar. Die Common Language Runtime verwendet die IConvertible-Schnittstelle auch intern in expliziten Schnittstellenimplementierungen, um Code zu vereinfachen, der Konvertierungen in der Convert-Klasse und Grundtypen der Common Language Runtime unterstützt.

Zusätzlich zur IConvertible-Schnittstelle stellt .NET Framework als Typkonverter bezeichnete Klassen für die Konvertierung von benutzerdefinierten Datentypen in andere Datentypen bereit. Weitere Informationen finden Sie im Thema Verallgemeinerte Typkonvertierung.

Im folgenden Codebeispiel wird eine Implementierung von IConvertible für eine Klasse komplexer Zahlen veranschaulicht, die es ermöglicht, zuerst eine Umwandlung in einen Double vorzunehmen und anschließend die statischen Convert-Member für diesen Double aufzurufen.

C#
C++
VB
Kopieren 
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 "( " + x.ToString() + " , " + y.ToString() + " )";
		}

		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;
			}
		}
	}
}
J#
Kopieren 
package ConsoleApplication2 ;
import System.*;
/// Class that implements IConvertible
class Complex implements IConvertible
{
    private double x;
    private double y;

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

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

    public boolean ToBoolean(IFormatProvider provider)
    {
        if (x != 0.0 || y != 0.0) {
            return true;
        }
        else {
            return false;
        }
    } //ToBoolean

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

    public ubyte ToByte(IFormatProvider provider)
    {
        return Convert.ToByte(GetDoubleValue());
    } //ToByte

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

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

    public System.Decimal ToDecimal(IFormatProvider provider)
    {
        return Convert.ToDecimal(GetDoubleValue());
    } //ToDecimal

    public double ToDouble(IFormatProvider provider)
    {
        return GetDoubleValue();
    } //ToDouble

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

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

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

    public byte ToSByte(IFormatProvider provider)
    {
        return Convert.ToSByte(GetDoubleValue());
    } //ToSByte

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

    public String ToString(IFormatProvider provider)
    {
        return "( " + System.Convert.ToString(x)
            + " , " + System.Convert.ToString(y)+ " )";
    } //ToString

    public Object ToType(Type conversionType, IFormatProvider provider)
    {
        return Convert.ChangeType(new Double(GetDoubleValue()),
            conversionType);
    } //ToType

    public UInt16 ToUInt16(IFormatProvider provider)
    {        
        return Convert.ToUInt16(GetDoubleValue());
    } //ToUInt16

    public UInt32 ToUInt32(IFormatProvider provider)
    {        
        return Convert.ToUInt32(GetDoubleValue());
    } //ToUInt32

    public UInt64 ToUInt64(IFormatProvider provider)
    {        
        return Convert.ToUInt64(GetDoubleValue());
    } //ToUInt64
} //Complex

/// <summary>
/// Summary description for Class1.
/// </summary>
class Class1
{
    public static void main(String[] args)
    {
        Complex testComplex = new Complex(4, 7);

        WriteObjectInfo(testComplex);
        WriteObjectInfo((System.Boolean)(Convert.ToBoolean(testComplex)));
        WriteObjectInfo(Convert.ToDecimal(testComplex));
        WriteObjectInfo(Convert.ToString(testComplex));
    } //main

    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;
        }
    } //WriteObjectInfo
} //Class1

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)