Típuskonvertálás a .NET-ben

Minden értékhez tartozik egy társított típus, amely olyan attribútumokat határoz meg, mint az értékhez lefoglalt terület mennyisége, a lehetséges értékek tartománya és az általa elérhetővé tett tagok. Számos érték több típusként is kifejezhető. A 4 érték például egész számként vagy lebegőpontos értékként is kifejezhető. A típuskonvertálás olyan értéket hoz létre egy új típusban, amely megegyezik egy régi típus értékével, de nem feltétlenül őrzi meg az eredeti objektum identitását (vagy pontos értékét).

A .NET automatikusan támogatja a következő átalakításokat:

• Konvertálás származtatott osztályból alaposztályra. Ez például azt jelenti, hogy bármely osztály vagy struktúra egy példánya átalakítható példánysá Object . Ehhez az átalakításhoz nincs szükség casting- vagy konverziós operátorra.

• Alaposztályból visszakonvertálás az eredeti származtatott osztályra. A C#-ban ehhez az átalakításhoz casting operátorra van szükség. A Visual Basicben szükség van az CType operátorra, ha Option Strict be van kapcsolva.

• Az illesztőt megvalósító típusból olyan felületobjektummá alakítható át, amely az adott interfészt jelöli. Ehhez az átalakításhoz nincs szükség casting- vagy konverziós operátorra.

• Az illesztőobjektumból visszakonvertálás az azt megvalósító eredeti típusra. A C#-ban ehhez az átalakításhoz casting operátorra van szükség. A Visual Basicben szükség van az CType operátorra, ha Option Strict be van kapcsolva.

Ezen automatikus átalakítások mellett a .NET számos olyan funkciót is kínál, amelyek támogatják az egyéni típuskonverziót. Ezek a következők:

• Az Implicit operátor, amely meghatározza a típusok közötti elérhető szélesítési konverziókat. További információkért tekintse meg az Implicit átalakítás implicit operátorral című szakaszát.

• Az Explicit operátor, amely meghatározza a típusok közötti elérhető szűkítési konverziókat. További információt az Explicit átalakítás az Explicit operátorral című szakaszban talál.

• Az IConvertible interfész, amely az egyes alap .NET-adattípusokra való konvertálást határozza meg. További információ: Az IConvertible Interface szakasz.

• Az Convert osztály, amely olyan metódusokat biztosít, amelyek implementálják a metódusokat a IConvertible felületen. További információ: Osztály konvertálása szakasz.

• Az TypeConverter osztály, amely egy alaposztály, amely kiterjeszthető egy adott típus bármely más típusra való konvertálásának támogatására. További információt a TypeConverter osztály szakaszában talál.

Implicit átalakítás az implicit operátorral

Az átalakítások szélesítéséhez új értékeket kell létrehozni egy meglévő típus értékéből, amely a céltípusnál szigorúbb tartományt vagy korlátozottabb taglistát tartalmaz. A konvertálások bővítése nem eredményezhet adatvesztést (bár ezek pontosságvesztést eredményezhetnek). Mivel az adatok nem veszhetnek el, a fordítók implicit módon vagy transzparensen kezelhetik az átalakítást anélkül, hogy explicit konverziós módszert vagy casting operátort kellene használniuk.

Feljegyzés

Bár az implicit konverziót végrehajtó kód meghívhat konverziós metódust vagy használhat egy casting operátort, az implicit konverziót támogató fordítók nem igénylik a használatát.

A típus például támogatja a , , , , UInt16Int32SByteUInt32Int64Int16és UInt64 értékek implicit Bytekonvertálását. CharDecimal Az alábbi példa néhány implicit konverziót mutat be, amikor értékeket rendel egy Decimal változóhoz.

  byte byteValue = 16;
  short shortValue = -1024;
  int intValue = -1034000;
  long longValue = 1152921504606846976;
  ulong ulongValue = UInt64.MaxValue;

  decimal decimalValue;

  decimalValue = byteValue;
  Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                    byteValue.GetType().Name, decimalValue);

  decimalValue = shortValue;
  Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                    shortValue.GetType().Name, decimalValue);

  decimalValue = intValue;
  Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                    intValue.GetType().Name, decimalValue);

  decimalValue = longValue;
  Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                    longValue.GetType().Name, decimalValue);

decimalValue = ulongValue;
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  ulongValue.GetType().Name, decimalValue);
// The example displays the following output:
//    After assigning a Byte value, the Decimal value is 16.
//    After assigning a Int16 value, the Decimal value is -1024.
//    After assigning a Int32 value, the Decimal value is -1034000.
//    After assigning a Int64 value, the Decimal value is 1152921504606846976.
//    After assigning a UInt64 value, the Decimal value is 18446744073709551615.

Dim byteValue As Byte = 16
Dim shortValue As Short = -1024
Dim intValue As Integer = -1034000
Dim longValue As Long = CLng(1024 ^ 6)
Dim ulongValue As ULong = ULong.MaxValue

Dim decimalValue As Decimal

decimalValue = byteValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  byteValue.GetType().Name, decimalValue)

decimalValue = shortValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  shortValue.GetType().Name, decimalValue)

decimalValue = intValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  intValue.GetType().Name, decimalValue)

decimalValue = longValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  longValue.GetType().Name, decimalValue)

decimalValue = ulongValue
Console.WriteLine("After assigning a {0} value, the Decimal value is {1}.",
                  ulongValue.GetType().Name, decimalValue)
' The example displays the following output:
'    After assigning a Byte value, the Decimal value is 16.
'    After assigning a Int16 value, the Decimal value is -1024.
'    After assigning a Int32 value, the Decimal value is -1034000.
'    After assigning a Int64 value, the Decimal value is 1152921504606846976.
'    After assigning a UInt64 value, the Decimal value is 18446744073709551615.

Ha egy adott nyelvi fordító támogatja az egyéni operátorokat, implicit konverziókat is definiálhat a saját egyéni típusaiban. Az alábbi példa egy aláírt bájt adattípus ByteWithSign részleges implementálását ismerteti, amely jel- és nagyságrendi ábrázolást használ. Támogatja az ByteSByte értékek implicit átalakítását értékekké ByteWithSign .

public struct ByteWithSign
{
    private SByte signValue;
    private Byte value;

    public static implicit operator ByteWithSign(SByte value)
    {
        ByteWithSign newValue;
        newValue.signValue = (SByte)Math.Sign(value);
        newValue.value = (byte)Math.Abs(value);
        return newValue;
    }

    public static implicit operator ByteWithSign(Byte value)
    {
        ByteWithSign newValue;
        newValue.signValue = 1;
        newValue.value = value;
        return newValue;
    }

    public override string ToString()
    {
        return (signValue * value).ToString();
    }
}

Public Structure ImplicitByteWithSign
    Private signValue As SByte
    Private value As Byte

    Public Overloads Shared Widening Operator CType(value As SByte) As ImplicitByteWithSign
        Dim newValue As ImplicitByteWithSign
        newValue.signValue = CSByte(Math.Sign(value))
        newValue.value = CByte(Math.Abs(value))
        Return newValue
    End Operator

    Public Overloads Shared Widening Operator CType(value As Byte) As ImplicitByteWithSign
        Dim NewValue As ImplicitByteWithSign
        newValue.signValue = 1
        newValue.value = value
        Return newValue
    End Operator

    Public Overrides Function ToString() As String
        Return (signValue * value).ToString()
    End Function
End Structure

Az ügyfélkód ezután deklarálhat egy változót ByteWithSign , és hozzárendelheti azt Byte és SByte az értékeket anélkül, hogy explicit átalakításokat hajtanak végre, vagy bármilyen casting operátort használnak, ahogy az alábbi példa is mutatja.

SByte sbyteValue = -120;
ByteWithSign value = sbyteValue;
Console.WriteLine(value);
value = Byte.MaxValue;
Console.WriteLine(value);
// The example displays the following output:
//       -120
//       255

Dim sbyteValue As SByte = -120
Dim value As ImplicitByteWithSign = sbyteValue
Console.WriteLine(value.ToString())
value = Byte.MaxValue
Console.WriteLine(value.ToString())
' The example displays the following output:
'       -120
'       255

Explicit átalakítás az explicit operátorral

A konverziók szűkítéséhez új értéket kell létrehozni egy meglévő típus értékéből, amely nagyobb tartományt vagy nagyobb taglistát tartalmaz, mint a céltípus. Mivel a szűkülő átalakítás adatvesztést eredményezhet, a fordítók gyakran megkövetelik, hogy az átalakítást explicit módon, egy konverziós metódusra vagy egy casting operátorra irányuló hívással lehessen elérni. Vagyis az átalakítást kifejezetten a fejlesztői kódban kell kezelni.

Feljegyzés

A konverziós módszer vagy a konverziók szűkítéséhez szükséges casting operátor fő célja, hogy a fejlesztő tisztában legyen az adatvesztés lehetőségével, vagy OverflowException hogy kódban kezelhető legyen. Egyes fordítók azonban enyhíthetik ezt a követelményt. A Visual Basicben például, ha Option Strict ki van kapcsolva (az alapértelmezett beállítás), a Visual Basic fordító implicit módon próbálja végrehajtani a szűkítő konverziókat.

A , , és UInt64 adattípusok például UInt32olyan tartományokkal rendelkeznek, amelyek túllépik az Int32 adattípust, ahogy az az alábbi táblázatban Int64látható.

Típus	Összehasonlítás az Int32 tartományával
Int64	Int64.MaxValue nagyobb, mint Int32.MaxValue, és Int64.MinValue kisebb , mint (nagyobb negatív tartománya van, mint) Int32.MinValue.
UInt32	UInt32.MaxValue nagyobb, mint Int32.MaxValue.
UInt64	UInt64.MaxValue nagyobb, mint Int32.MaxValue.

Az ilyen szűkítő konverziók kezeléséhez a .NET lehetővé teszi, hogy a típusok operátort Explicit definiáljanak. Az egyes nyelvfordítók ezt az operátort saját szintaxissal implementálhatják, vagy az Convert osztály egy tagját meghívhatják az átalakítás végrehajtásához. (Az osztályról a témakör későbbi részében, az Convert Osztály konvertálása című témakörben talál további információt.) Az alábbi példa a nyelvi funkciók használatát mutatja be ezeknek a potenciálisan tartományon kívüli egész számok értékekké történő explicit átalakításának Int32 kezeléséhez.

long number1 = int.MaxValue + 20L;
uint number2 = int.MaxValue - 1000;
ulong number3 = int.MaxValue;

int intNumber;

try
{
    intNumber = checked((int)number1);
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                      number1.GetType().Name, intNumber);
}
catch (OverflowException)
{
    if (number1 > int.MaxValue)
        Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                          number1, int.MaxValue);
    else
        Console.WriteLine("Conversion failed: {0} is less than {1}.",
                          number1, int.MinValue);
}

try
{
    intNumber = checked((int)number2);
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                      number2.GetType().Name, intNumber);
}
catch (OverflowException)
{
    Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                      number2, int.MaxValue);
}

try
{
    intNumber = checked((int)number3);
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                      number3.GetType().Name, intNumber);
}
catch (OverflowException)
{
    Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                      number1, int.MaxValue);
}

// The example displays the following output:
//    Conversion failed: 2147483667 exceeds 2147483647.
//    After assigning a UInt32 value, the Integer value is 2147482647.
//    After assigning a UInt64 value, the Integer value is 2147483647.

Dim number1 As Long = Integer.MaxValue + 20L
Dim number2 As UInteger = Integer.MaxValue - 1000
Dim number3 As ULong = Integer.MaxValue

Dim intNumber As Integer

Try
    intNumber = CInt(number1)
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                        number1.GetType().Name, intNumber)
Catch e As OverflowException
    If number1 > Integer.MaxValue Then
        Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                                          number1, Integer.MaxValue)
    Else
        Console.WriteLine("Conversion failed: {0} is less than {1}.\n",
                                          number1, Integer.MinValue)
    End If
End Try

Try
    intNumber = CInt(number2)
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                        number2.GetType().Name, intNumber)
Catch e As OverflowException
    Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                                      number2, Integer.MaxValue)
End Try

Try
    intNumber = CInt(number3)
    Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
                        number3.GetType().Name, intNumber)
Catch e As OverflowException
    Console.WriteLine("Conversion failed: {0} exceeds {1}.",
                                      number1, Integer.MaxValue)
End Try
' The example displays the following output:
'    Conversion failed: 2147483667 exceeds 2147483647.
'    After assigning a UInt32 value, the Integer value is 2147482647.
'    After assigning a UInt64 value, the Integer value is 2147483647.

Az explicit konverziók eltérő eredményeket hozhatnak különböző nyelveken, és ezek az eredmények eltérhetnek a megfelelő Convert módszer által visszaadott értéktől. Ha például a Double 12.63251 értéket konvertálja Int32a rendszer, akkor a Visual Basic CInt és a .NET Convert.ToInt32(Double) metódus is kerekítve Double 13 értéket ad vissza, a C# (int) operátor viszont csonkolja a Double 12-et. A C# (int) -operátor ugyanígy nem támogatja a logikai egész számok konvertálását, de a Visual Basic CInt metódus -1 értéket true konvertál. A metódus viszont Convert.ToInt32(Boolean) 1 értékre konvertálja true az értéket.

A legtöbb fordító lehetővé teszi, hogy a explicit átalakítások ellenőrzött vagy nem ellenőrzött módon legyenek végrehajtva. Ha ellenőrzött átalakítást végez, a rendszer akkor ad vissza egy OverflowException értéket, ha a konvertálni kívánt típus értéke kívül esik a céltípus tartományán. Ha a nem ellenőrzött átalakítás ugyanazon feltételek mellett történik, előfordulhat, hogy az átalakítás nem jelent kivételt, de a pontos viselkedés nem lesz definiálva, és helytelen érték következhet be.

Feljegyzés

A C#-ban az ellenőrzött konverziók elvégezhetők a kulcsszó és egy checked casting operátor együttes használatával, vagy a /checked+ fordító beállításának megadásával. Ezzel szemben a nem ellenőrzött konverziók elvégezhetők a kulcsszó és az unchecked öntő operátor együttes használatával, vagy a /checked- fordító beállításának megadásával. Alapértelmezés szerint a explicit konverziók nincsenek bejelölve. A Visual Basicben az ellenőrzött konverziók a projekt Speciális fordító Gépház párbeszédpanelén az Egész szám túlcsordulás eltávolítása jelölőnégyzet jelölésének törlésével vagy a /removeintchecks- fordító beállítás megadásával végezhetők el. Ezzel szemben a nem ellenőrzött átalakítások elvégezhetők a projekt Speciális fordító Gépház párbeszédpanelén az Egész szám túlcsordulás eltávolítása jelölőnégyzet bejelölésével vagy a /removeintchecks+ fordító beállításának megadásával. Alapértelmezés szerint a explicit konverziók vannak bejelölve.

Az alábbi C#-példa a checked kulcsszavakkal unchecked szemlélteti a viselkedésbeli különbséget, ha egy tartományon Byte kívüli értéket konvertál egy Byte. Az ellenőrzött átalakítás kivételt eredményez, de a nem ellenőrzött átalakítás hozzá van rendelve Byte.MaxValue a Byte változóhoz.

int largeValue = Int32.MaxValue;
byte newValue;

try
{
    newValue = unchecked((byte)largeValue);
    Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                      largeValue.GetType().Name, largeValue,
                      newValue.GetType().Name, newValue);
}
catch (OverflowException)
{
    Console.WriteLine("{0} is outside the range of the Byte data type.",
                      largeValue);
}

try
{
    newValue = checked((byte)largeValue);
    Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                      largeValue.GetType().Name, largeValue,
                      newValue.GetType().Name, newValue);
}
catch (OverflowException)
{
    Console.WriteLine("{0} is outside the range of the Byte data type.",
                      largeValue);
}
// The example displays the following output:
//    Converted the Int32 value 2147483647 to the Byte value 255.
//    2147483647 is outside the range of the Byte data type.

Ha egy adott nyelvi fordító támogatja az egyéni túlterhelt operátorokat, explicit konverziókat is definiálhat a saját egyéni típusaiban. Az alábbi példa egy aláírt bájt adattípus ByteWithSign részleges implementálását ismerteti, amely jel- és nagyságrendi ábrázolást használ. Támogatja az értékek explicit értékké alakítását Int32UInt32ByteWithSign .

public struct ByteWithSignE
{
    private SByte signValue;
    private Byte value;

    private const byte MaxValue = byte.MaxValue;
    private const int MinValue = -1 * byte.MaxValue;

    public static explicit operator ByteWithSignE(int value)
    {
        // Check for overflow.
        if (value > ByteWithSignE.MaxValue || value < ByteWithSignE.MinValue)
            throw new OverflowException(String.Format("'{0}' is out of range of the ByteWithSignE data type.",
                                                      value));

        ByteWithSignE newValue;
        newValue.signValue = (SByte)Math.Sign(value);
        newValue.value = (byte)Math.Abs(value);
        return newValue;
    }

    public static explicit operator ByteWithSignE(uint value)
    {
        if (value > ByteWithSignE.MaxValue)
            throw new OverflowException(String.Format("'{0}' is out of range of the ByteWithSignE data type.",
                                                      value));

        ByteWithSignE newValue;
        newValue.signValue = 1;
        newValue.value = (byte)value;
        return newValue;
    }

    public override string ToString()
    {
        return (signValue * value).ToString();
    }
}

Public Structure ByteWithSign
    Private signValue As SByte
    Private value As Byte

    Private Const MaxValue As Byte = Byte.MaxValue
    Private Const MinValue As Integer = -1 * Byte.MaxValue

    Public Overloads Shared Narrowing Operator CType(value As Integer) As ByteWithSign
        ' Check for overflow.
        If value > ByteWithSign.MaxValue Or value < ByteWithSign.MinValue Then
            Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
        End If

        Dim newValue As ByteWithSign

        newValue.signValue = CSByte(Math.Sign(value))
        newValue.value = CByte(Math.Abs(value))
        Return newValue
    End Operator

    Public Overloads Shared Narrowing Operator CType(value As UInteger) As ByteWithSign
        If value > ByteWithSign.MaxValue Then
            Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
        End If

        Dim NewValue As ByteWithSign

        newValue.signValue = 1
        newValue.value = CByte(value)
        Return newValue
    End Operator

    Public Overrides Function ToString() As String
        Return (signValue * value).ToString()
    End Function
End Structure

Az ügyfélkód ezután deklarálhat egy változót ByteWithSign , és hozzárendelheti azt Int32 és UInt32 az értékeket, ha a hozzárendelések casting operátort vagy konverziós módszert is tartalmaznak, ahogyan az alábbi példa mutatja.

ByteWithSignE value;

try
{
    int intValue = -120;
    value = (ByteWithSignE)intValue;
    Console.WriteLine(value);
}
catch (OverflowException e)
{
    Console.WriteLine(e.Message);
}

try
{
    uint uintValue = 1024;
    value = (ByteWithSignE)uintValue;
    Console.WriteLine(value);
}
catch (OverflowException e)
{
    Console.WriteLine(e.Message);
}
// The example displays the following output:
//       -120
//       '1024' is out of range of the ByteWithSignE data type.

Dim value As ByteWithSign

Try
    Dim intValue As Integer = -120
    value = CType(intValue, ByteWithSign)
    Console.WriteLine(value)
Catch e As OverflowException
    Console.WriteLine(e.Message)
End Try

Try
    Dim uintValue As UInteger = 1024
    value = CType(uintValue, ByteWithSign)
    Console.WriteLine(value)
Catch e As OverflowException
    Console.WriteLine(e.Message)
End Try
' The example displays the following output:
'       -120
'       '1024' is out of range of the ByteWithSign data type.

Az IConvertible felület

Bármilyen típus közös nyelvi futtatókörnyezeti alaptípusra való konvertálásának támogatásához a .NET biztosítja a IConvertible felületet. A implementálási típus a következők megadásához szükséges:

• Egy metódus, amely a TypeCode implementálási típust adja vissza.

• Metódusok a implementálási típus konvertálásához minden közös nyelvi futtatókörnyezeti alaptípusra (Boolean, , Byte, DateTime, Decimalstb Double.).

• Általánosított konverziós módszer a implementálási típus egy példányának egy másik megadott típussá alakításához. A nem támogatott konverzióknak egy InvalidCastException.

Minden közös nyelvi futtatókörnyezeti alaptípus (azaz a Boolean, , Byte, Char, DateTimeDecimal, , DoubleInt16, SingleStringInt64UInt16SByteInt32, , UInt32, és UInt64), valamint a DBNull felület implementálása IConvertible és Enum típusa. Ezek azonban explicit felületi implementációk; a konvertálási módszer csak egy IConvertible interfészváltozón keresztül hívható meg, ahogyan az alábbi példa is mutatja. Ez a példa egy Int32 értéket az azzal egyenértékű Char értékké alakít át.

int codePoint = 1067;
IConvertible iConv = codePoint;
char ch = iConv.ToChar(null);
Console.WriteLine("Converted {0} to {1}.", codePoint, ch);

Dim codePoint As Integer = 1067
Dim iConv As IConvertible = codePoint
Dim ch As Char = iConv.ToChar(Nothing)
Console.WriteLine("Converted {0} to {1}.", codePoint, ch)

A konvertálási módszernek a implementálási típus helyett a felületén való meghívásának követelménye viszonylag költségessé teszi az explicit felületi implementációkat. Ehelyett azt javasoljuk, hogy hívja meg az osztály megfelelő tagját a Convert közös nyelvi futtatókörnyezeti alaptípusok közötti konvertáláshoz. További információkért lásd a következő, Az osztály konvertálása című szakaszt.

Feljegyzés

A .NET által biztosított felületen és osztályon kívül IConvertible az Convert egyes nyelvek is módot biztosíthatnak a konverziók elvégzésére. A C# például casting operátorokat használ; A Visual Basic fordító által implementált konverziós függvényeket használ, például CType: , CIntés DirectCast.

A felület többnyire a IConvertible .NET alaptípusai közötti átalakítás támogatására lett tervezve. A felület azonban egyéni típussal is implementálható az adott típus más egyéni típusokra való konvertálásának támogatásához. További információkért tekintse meg az Egyéni átalakítások a ChangeType metódussal című szakaszt a jelen témakör későbbi részében.

A Konvertálás osztály

Bár az egyes alaptípusok felületi implementációja IConvertible meghívható típuskonverzió végrehajtásához, az System.Convert osztály metódusainak meghívása az ajánlott nyelvsemleges módszer az egyik alaptípusról a másikra való konvertáláshoz. Convert.ChangeType(Object, Type, IFormatProvider) A metódus emellett egy megadott egyéni típusból egy másik típussá alakítható át.

Alaptípusok közötti konverziók

Az Convert osztály nyelvsemleges módot biztosít az alaptípusok közötti konverziók végrehajtására, és minden olyan nyelv számára elérhető, amely a közös nyelvi futtatókörnyezetet célozza. Az átalakítások szélesítésére és szűkítésére egyaránt használható módszerek teljes halmazát biztosítja, és nem támogatott konverziókhoz (például egy DateTime érték egész számmá való konvertálásához) ad InvalidCastException vissza. A konvertálások szűkítése ellenőrzött környezetben történik, és ha az átalakítás sikertelen, a rendszer eldobja OverflowException a konverziót.

Fontos

Mivel az Convert osztály az egyes alaptípusokra és azok alapján konvertálható metódusokat is tartalmaz, nem szükséges meghívni az egyes alaptípusok explicit felületi implementációját IConvertible .

Az alábbi példa azt szemlélteti, hogy az System.Convert osztály a .NET-alaptípusok közötti számos tágítási és szűkítési konverzió végrehajtására használható.

// Convert an Int32 value to a Decimal (a widening conversion).
int integralValue = 12534;
decimal decimalValue = Convert.ToDecimal(integralValue);
Console.WriteLine("Converted the {0} value {1} to " +
                                  "the {2} value {3:N2}.",
                                  integralValue.GetType().Name,
                                  integralValue,
                                  decimalValue.GetType().Name,
                                  decimalValue);
// Convert a Byte value to an Int32 value (a widening conversion).
byte byteValue = Byte.MaxValue;
int integralValue2 = Convert.ToInt32(byteValue);
Console.WriteLine("Converted the {0} value {1} to " +
                                  "the {2} value {3:G}.",
                                  byteValue.GetType().Name,
                                  byteValue,
                                  integralValue2.GetType().Name,
                                  integralValue2);

// Convert a Double value to an Int32 value (a narrowing conversion).
double doubleValue = 16.32513e12;
try
{
    long longValue = Convert.ToInt64(doubleValue);
    Console.WriteLine("Converted the {0} value {1:E} to " +
                                      "the {2} value {3:N0}.",
                                      doubleValue.GetType().Name,
                                      doubleValue,
                                      longValue.GetType().Name,
                                      longValue);
}
catch (OverflowException)
{
    Console.WriteLine("Unable to convert the {0:E} value {1}.",
                                      doubleValue.GetType().Name, doubleValue);
}

// Convert a signed byte to a byte (a narrowing conversion).
sbyte sbyteValue = -16;
try
{
    byte byteValue2 = Convert.ToByte(sbyteValue);
    Console.WriteLine("Converted the {0} value {1} to " +
                                      "the {2} value {3:G}.",
                                      sbyteValue.GetType().Name,
                                      sbyteValue,
                                      byteValue2.GetType().Name,
                                      byteValue2);
}
catch (OverflowException)
{
    Console.WriteLine("Unable to convert the {0} value {1}.",
                                      sbyteValue.GetType().Name, sbyteValue);
}
// The example displays the following output:
//       Converted the Int32 value 12534 to the Decimal value 12,534.00.
//       Converted the Byte value 255 to the Int32 value 255.
//       Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
//       Unable to convert the SByte value -16.

' Convert an Int32 value to a Decimal (a widening conversion).
Dim integralValue As Integer = 12534
Dim decimalValue As Decimal = Convert.ToDecimal(integralValue)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3:N2}.",
                  integralValue.GetType().Name,
                  integralValue,
                  decimalValue.GetType().Name,
                  decimalValue)

' Convert a Byte value to an Int32 value (a widening conversion).
Dim byteValue As Byte = Byte.MaxValue
Dim integralValue2 As Integer = Convert.ToInt32(byteValue)
Console.WriteLine("Converted the {0} value {1} to " +
                                  "the {2} value {3:G}.",
                                  byteValue.GetType().Name,
                                  byteValue,
                                  integralValue2.GetType().Name,
                                  integralValue2)

' Convert a Double value to an Int32 value (a narrowing conversion).
Dim doubleValue As Double = 16.32513e12
Try
    Dim longValue As Long = Convert.ToInt64(doubleValue)
    Console.WriteLine("Converted the {0} value {1:E} to " +
                                      "the {2} value {3:N0}.",
                                      doubleValue.GetType().Name,
                                      doubleValue,
                                      longValue.GetType().Name,
                                      longValue)
Catch e As OverflowException
    Console.WriteLine("Unable to convert the {0:E} value {1}.",
                                      doubleValue.GetType().Name, doubleValue)
End Try

' Convert a signed byte to a byte (a narrowing conversion).     
Dim sbyteValue As SByte = -16
Try
    Dim byteValue2 As Byte = Convert.ToByte(sbyteValue)
    Console.WriteLine("Converted the {0} value {1} to " +
                                      "the {2} value {3:G}.",
                                      sbyteValue.GetType().Name,
                                      sbyteValue,
                                      byteValue2.GetType().Name,
                                      byteValue2)
Catch e As OverflowException
    Console.WriteLine("Unable to convert the {0} value {1}.",
                                      sbyteValue.GetType().Name, sbyteValue)
End Try
' The example displays the following output:
'       Converted the Int32 value 12534 to the Decimal value 12,534.00.
'       Converted the Byte value 255 to the Int32 value 255.
'       Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
'       Unable to convert the SByte value -16.

Bizonyos esetekben, különösen a lebegőpontos értékekre való konvertáláskor, az átalakítás a pontosság elvesztésével járhat, még akkor is, ha nem ad vissza OverflowException. Az alábbi példa ezt a pontosságvesztést szemlélteti. Az első esetben Decimal egy érték kisebb pontosságú (kevesebb jelentős számjegy), amikor átalakítják .Double A második esetben Double egy érték kerekítése 42,72-ről 43-ra történik az átalakítás befejezéséhez.

double doubleValue;

// Convert a Double to a Decimal.
decimal decimalValue = 13956810.96702888123451471211m;
doubleValue = Convert.ToDouble(decimalValue);
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue);

doubleValue = 42.72;
try
{
    int integerValue = Convert.ToInt32(doubleValue);
    Console.WriteLine("{0} converted to {1}.",
                                      doubleValue, integerValue);
}
catch (OverflowException)
{
    Console.WriteLine("Unable to convert {0} to an integer.",
                                      doubleValue);
}
// The example displays the following output:
//       13956810.96702888123451471211 converted to 13956810.9670289.
//       42.72 converted to 43.

Dim doubleValue As Double

' Convert a Double to a Decimal.
Dim decimalValue As Decimal = 13956810.96702888123451471211d
doubleValue = Convert.ToDouble(decimalValue)
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue)

doubleValue = 42.72
Try
    Dim integerValue As Integer = Convert.ToInt32(doubleValue)
    Console.WriteLine("{0} converted to {1}.",
                                      doubleValue, integerValue)
Catch e As OverflowException
    Console.WriteLine("Unable to convert {0} to an integer.",
                                      doubleValue)
End Try
' The example displays the following output:
'       13956810.96702888123451471211 converted to 13956810.9670289.
'       42.72 converted to 43.

Az osztály által támogatott szélesítési és szűkítési konverziókat is felsoroló táblák esetében lásd a Convert Típuskonvertálási táblák című témakört.

Egyéni konverziók a ChangeType metódussal

Amellett, hogy támogatja az egyes alaptípusokra történő átalakításokat, az Convert osztály használható az egyéni típusok egy vagy több előre definiált típussá alakítására. Ezt az átalakítást a Convert.ChangeType(Object, Type, IFormatProvider) metódus hajtja végre, amely viszont a paraméter metódusára value irányuló IConvertible.ToType hívást tördeli. Ez azt jelenti, hogy a paraméter által value képviselt objektumnak biztosítania kell az interfész implementálását IConvertible .

Feljegyzés

Mivel a Convert.ChangeType(Object, Type) metódusok egy Convert.ChangeType(Object, Type, IFormatProvider) objektummal Type határozzák meg a konvertált céltípust value , dinamikus átalakítást végezhetnek egy olyan objektumra, amelynek típusa fordításkor nem ismert. Vegye figyelembe azonban, hogy a IConvertible megvalósításnak továbbra is támogatnia value kell ezt az átalakítást.

Az alábbi példa a felület olyan lehetséges megvalósítását szemlélteti IConvertible , amely lehetővé teszi az TemperatureCelsius objektum objektummá alakítását TemperatureFahrenheit , és fordítva. A példa egy alaposztályt határoz meg, amely implementálja az IConvertible interfészt, Temperatureés felülbírálja a metódustObject.ToString. Az egyes származtatott TemperatureCelsius és TemperatureFahrenheit osztályos osztályok felülbírálják az ToType alaposztály és a ToString metódusok használatát.

using System;

public abstract class Temperature : IConvertible
{
    protected decimal temp;

    public Temperature(decimal temperature)
    {
        this.temp = temperature;
    }

    public decimal Value
    {
        get { return this.temp; }
        set { this.temp = value; }
    }

    public override string ToString()
    {
        return temp.ToString(null as IFormatProvider) + "º";
    }

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

    public bool ToBoolean(IFormatProvider provider)
    {
        throw new InvalidCastException(String.Format("Temperature-to-Boolean conversion is not supported."));
    }

    public byte ToByte(IFormatProvider provider)
    {
        if (temp < Byte.MinValue || temp > Byte.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the Byte data type.", temp));
        else
            return (byte)temp;
    }

    public char ToChar(IFormatProvider provider)
    {
        throw new InvalidCastException("Temperature-to-Char conversion is not supported.");
    }

    public DateTime ToDateTime(IFormatProvider provider)
    {
        throw new InvalidCastException("Temperature-to-DateTime conversion is not supported.");
    }

    public decimal ToDecimal(IFormatProvider provider)
    {
        return temp;
    }

    public double ToDouble(IFormatProvider provider)
    {
        return (double)temp;
    }

    public short ToInt16(IFormatProvider provider)
    {
        if (temp < Int16.MinValue || temp > Int16.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the Int16 data type.", temp));
        else
            return (short)Math.Round(temp);
    }

    public int ToInt32(IFormatProvider provider)
    {
        if (temp < Int32.MinValue || temp > Int32.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the Int32 data type.", temp));
        else
            return (int)Math.Round(temp);
    }

    public long ToInt64(IFormatProvider provider)
    {
        if (temp < Int64.MinValue || temp > Int64.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the Int64 data type.", temp));
        else
            return (long)Math.Round(temp);
    }

    public sbyte ToSByte(IFormatProvider provider)
    {
        if (temp < SByte.MinValue || temp > SByte.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the SByte data type.", temp));
        else
            return (sbyte)temp;
    }

    public float ToSingle(IFormatProvider provider)
    {
        return (float)temp;
    }

    public virtual string ToString(IFormatProvider provider)
    {
        return temp.ToString(provider) + "°";
    }

    // If conversionType is implemented by another IConvertible method, call it.
    public virtual object ToType(Type conversionType, IFormatProvider provider)
    {
        switch (Type.GetTypeCode(conversionType))
        {
            case TypeCode.Boolean:
                return this.ToBoolean(provider);
            case TypeCode.Byte:
                return this.ToByte(provider);
            case TypeCode.Char:
                return this.ToChar(provider);
            case TypeCode.DateTime:
                return this.ToDateTime(provider);
            case TypeCode.Decimal:
                return this.ToDecimal(provider);
            case TypeCode.Double:
                return this.ToDouble(provider);
            case TypeCode.Empty:
                throw new NullReferenceException("The target type is null.");
            case TypeCode.Int16:
                return this.ToInt16(provider);
            case TypeCode.Int32:
                return this.ToInt32(provider);
            case TypeCode.Int64:
                return this.ToInt64(provider);
            case TypeCode.Object:
                // Leave conversion of non-base types to derived classes.
                throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
                                               conversionType.Name));
            case TypeCode.SByte:
                return this.ToSByte(provider);
            case TypeCode.Single:
                return this.ToSingle(provider);
            case TypeCode.String:
                IConvertible iconv = this;
                return iconv.ToString(provider);
            case TypeCode.UInt16:
                return this.ToUInt16(provider);
            case TypeCode.UInt32:
                return this.ToUInt32(provider);
            case TypeCode.UInt64:
                return this.ToUInt64(provider);
            default:
                throw new InvalidCastException("Conversion not supported.");
        }
    }

    public ushort ToUInt16(IFormatProvider provider)
    {
        if (temp < UInt16.MinValue || temp > UInt16.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the UInt16 data type.", temp));
        else
            return (ushort)Math.Round(temp);
    }

    public uint ToUInt32(IFormatProvider provider)
    {
        if (temp < UInt32.MinValue || temp > UInt32.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the UInt32 data type.", temp));
        else
            return (uint)Math.Round(temp);
    }

    public ulong ToUInt64(IFormatProvider provider)
    {
        if (temp < UInt64.MinValue || temp > UInt64.MaxValue)
            throw new OverflowException(String.Format("{0} is out of range of the UInt64 data type.", temp));
        else
            return (ulong)Math.Round(temp);
    }
}

public class TemperatureCelsius : Temperature, IConvertible
{
    public TemperatureCelsius(decimal value) : base(value)
    {
    }

    // Override ToString methods.
    public override string ToString()
    {
        return this.ToString(null);
    }

    public override string ToString(IFormatProvider provider)
    {
        return temp.ToString(provider) + "°C";
    }

    // If conversionType is a implemented by another IConvertible method, call it.
    public override object ToType(Type conversionType, IFormatProvider provider)
    {
        // For non-objects, call base method.
        if (Type.GetTypeCode(conversionType) != TypeCode.Object)
        {
            return base.ToType(conversionType, provider);
        }
        else
        {
            if (conversionType.Equals(typeof(TemperatureCelsius)))
                return this;
            else if (conversionType.Equals(typeof(TemperatureFahrenheit)))
                return new TemperatureFahrenheit((decimal)this.temp * 9 / 5 + 32);
            else
                throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
                                               conversionType.Name));
        }
    }
}

public class TemperatureFahrenheit : Temperature, IConvertible
{
    public TemperatureFahrenheit(decimal value) : base(value)
    {
    }

    // Override ToString methods.
    public override string ToString()
    {
        return this.ToString(null);
    }

    public override string ToString(IFormatProvider provider)
    {
        return temp.ToString(provider) + "°F";
    }

    public override object ToType(Type conversionType, IFormatProvider provider)
    {
        // For non-objects, call base method.
        if (Type.GetTypeCode(conversionType) != TypeCode.Object)
        {
            return base.ToType(conversionType, provider);
        }
        else
        {
            // Handle conversion between derived classes.
            if (conversionType.Equals(typeof(TemperatureFahrenheit)))
                return this;
            else if (conversionType.Equals(typeof(TemperatureCelsius)))
                return new TemperatureCelsius((decimal)(this.temp - 32) * 5 / 9);
            // Unspecified object type: throw an InvalidCastException.
            else
                throw new InvalidCastException(String.Format("Cannot convert from Temperature to {0}.",
                                               conversionType.Name));
        }
    }
}

Public MustInherit Class Temperature
    Implements IConvertible

    Protected temp As Decimal

    Public Sub New(temperature As Decimal)
        Me.temp = temperature
    End Sub

    Public Property Value As Decimal
        Get
            Return Me.temp
        End Get
        Set
            Me.temp = Value
        End Set
    End Property

    Public Overrides Function ToString() As String
        Return temp.ToString() & "º"
    End Function

    ' IConvertible implementations.
    Public Function GetTypeCode() As TypeCode Implements IConvertible.GetTypeCode
        Return TypeCode.Object
    End Function

    Public Function ToBoolean(provider As IFormatProvider) As Boolean Implements IConvertible.ToBoolean
        Throw New InvalidCastException(String.Format("Temperature-to-Boolean conversion is not supported."))
    End Function

    Public Function ToByte(provider As IFormatProvider) As Byte Implements IConvertible.ToByte
        If temp < Byte.MinValue Or temp > Byte.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the Byte data type.", temp))
        Else
            Return CByte(temp)
        End If
    End Function

    Public Function ToChar(provider As IFormatProvider) As Char Implements IConvertible.ToChar
        Throw New InvalidCastException("Temperature-to-Char conversion is not supported.")
    End Function

    Public Function ToDateTime(provider As IFormatProvider) As DateTime Implements IConvertible.ToDateTime
        Throw New InvalidCastException("Temperature-to-DateTime conversion is not supported.")
    End Function

    Public Function ToDecimal(provider As IFormatProvider) As Decimal Implements IConvertible.ToDecimal
        Return temp
    End Function

    Public Function ToDouble(provider As IFormatProvider) As Double Implements IConvertible.ToDouble
        Return CDbl(temp)
    End Function

    Public Function ToInt16(provider As IFormatProvider) As Int16 Implements IConvertible.ToInt16
        If temp < Int16.MinValue Or temp > Int16.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the Int16 data type.", temp))
        End If
        Return CShort(Math.Round(temp))
    End Function

    Public Function ToInt32(provider As IFormatProvider) As Int32 Implements IConvertible.ToInt32
        If temp < Int32.MinValue Or temp > Int32.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the Int32 data type.", temp))
        End If
        Return CInt(Math.Round(temp))
    End Function

    Public Function ToInt64(provider As IFormatProvider) As Int64 Implements IConvertible.ToInt64
        If temp < Int64.MinValue Or temp > Int64.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the Int64 data type.", temp))
        End If
        Return CLng(Math.Round(temp))
    End Function

    Public Function ToSByte(provider As IFormatProvider) As SByte Implements IConvertible.ToSByte
        If temp < SByte.MinValue Or temp > SByte.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the SByte data type.", temp))
        Else
            Return CSByte(temp)
        End If
    End Function

    Public Function ToSingle(provider As IFormatProvider) As Single Implements IConvertible.ToSingle
        Return CSng(temp)
    End Function

    Public Overridable Overloads Function ToString(provider As IFormatProvider) As String Implements IConvertible.ToString
        Return temp.ToString(provider) & " °C"
    End Function

    ' If conversionType is a implemented by another IConvertible method, call it.
    Public Overridable Function ToType(conversionType As Type, provider As IFormatProvider) As Object Implements IConvertible.ToType
        Select Case Type.GetTypeCode(conversionType)
            Case TypeCode.Boolean
                Return Me.ToBoolean(provider)
            Case TypeCode.Byte
                Return Me.ToByte(provider)
            Case TypeCode.Char
                Return Me.ToChar(provider)
            Case TypeCode.DateTime
                Return Me.ToDateTime(provider)
            Case TypeCode.Decimal
                Return Me.ToDecimal(provider)
            Case TypeCode.Double
                Return Me.ToDouble(provider)
            Case TypeCode.Empty
                Throw New NullReferenceException("The target type is null.")
            Case TypeCode.Int16
                Return Me.ToInt16(provider)
            Case TypeCode.Int32
                Return Me.ToInt32(provider)
            Case TypeCode.Int64
                Return Me.ToInt64(provider)
            Case TypeCode.Object
                ' Leave conversion of non-base types to derived classes.
                Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
                                               conversionType.Name))
            Case TypeCode.SByte
                Return Me.ToSByte(provider)
            Case TypeCode.Single
                Return Me.ToSingle(provider)
            Case TypeCode.String
                Return Me.ToString(provider)
            Case TypeCode.UInt16
                Return Me.ToUInt16(provider)
            Case TypeCode.UInt32
                Return Me.ToUInt32(provider)
            Case TypeCode.UInt64
                Return Me.ToUInt64(provider)
            Case Else
                Throw New InvalidCastException("Conversion not supported.")
        End Select
    End Function

    Public Function ToUInt16(provider As IFormatProvider) As UInt16 Implements IConvertible.ToUInt16
        If temp < UInt16.MinValue Or temp > UInt16.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the UInt16 data type.", temp))
        End If
        Return CUShort(Math.Round(temp))
    End Function

    Public Function ToUInt32(provider As IFormatProvider) As UInt32 Implements IConvertible.ToUInt32
        If temp < UInt32.MinValue Or temp > UInt32.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the UInt32 data type.", temp))
        End If
        Return CUInt(Math.Round(temp))
    End Function

    Public Function ToUInt64(provider As IFormatProvider) As UInt64 Implements IConvertible.ToUInt64
        If temp < UInt64.MinValue Or temp > UInt64.MaxValue Then
            Throw New OverflowException(String.Format("{0} is out of range of the UInt64 data type.", temp))
        End If
        Return CULng(Math.Round(temp))
    End Function
End Class

Public Class TemperatureCelsius : Inherits Temperature : Implements IConvertible
    Public Sub New(value As Decimal)
        MyBase.New(value)
    End Sub

    ' Override ToString methods.
    Public Overrides Function ToString() As String
        Return Me.ToString(Nothing)
    End Function

    Public Overrides Function ToString(provider As IFormatProvider) As String
        Return temp.ToString(provider) + "°C"
    End Function

    ' If conversionType is a implemented by another IConvertible method, call it.
    Public Overrides Function ToType(conversionType As Type, provider As IFormatProvider) As Object
        ' For non-objects, call base method.
        If Type.GetTypeCode(conversionType) <> TypeCode.Object Then
            Return MyBase.ToType(conversionType, provider)
        Else
            If conversionType.Equals(GetType(TemperatureCelsius)) Then
                Return Me
            ElseIf conversionType.Equals(GetType(TemperatureFahrenheit))
                Return New TemperatureFahrenheit(CDec(Me.temp * 9 / 5 + 32))
                ' Unspecified object type: throw an InvalidCastException.
            Else
                Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
                                               conversionType.Name))
            End If
        End If
    End Function
End Class

Public Class TemperatureFahrenheit : Inherits Temperature : Implements IConvertible
    Public Sub New(value As Decimal)
        MyBase.New(value)
    End Sub

    ' Override ToString methods.
    Public Overrides Function ToString() As String
        Return Me.ToString(Nothing)
    End Function

    Public Overrides Function ToString(provider As IFormatProvider) As String
        Return temp.ToString(provider) + "°F"
    End Function

    Public Overrides Function ToType(conversionType As Type, provider As IFormatProvider) As Object
        ' For non-objects, call base method.
        If Type.GetTypeCode(conversionType) <> TypeCode.Object Then
            Return MyBase.ToType(conversionType, provider)
        Else
            ' Handle conversion between derived classes.
            If conversionType.Equals(GetType(TemperatureFahrenheit)) Then
                Return Me
            ElseIf conversionType.Equals(GetType(TemperatureCelsius))
                Return New TemperatureCelsius(CDec((MyBase.temp - 32) * 5 / 9))
                ' Unspecified object type: throw an InvalidCastException.
            Else
                Throw New InvalidCastException(String.Format("Cannot convert from Temperature to {0}.", _
                                               conversionType.Name))
            End If
        End If
    End Function
End Class

Az alábbi példa több ilyen IConvertible implementációra irányuló hívást mutat be, hogy objektumokat alakítson át TemperatureCelsius objektumokká TemperatureFahrenheit , és fordítva.

TemperatureCelsius tempC1 = new TemperatureCelsius(0);
TemperatureFahrenheit tempF1 = (TemperatureFahrenheit)Convert.ChangeType(tempC1, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempF1);
TemperatureCelsius tempC2 = (TemperatureCelsius)Convert.ChangeType(tempC1, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempC2);
TemperatureFahrenheit tempF2 = new TemperatureFahrenheit(212);
TemperatureCelsius tempC3 = (TemperatureCelsius)Convert.ChangeType(tempF2, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempC3);
TemperatureFahrenheit tempF3 = (TemperatureFahrenheit)Convert.ChangeType(tempF2, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempF3);
// The example displays the following output:
//       0°C equals 32°F.
//       0°C equals 0°C.
//       212°F equals 100°C.
//       212°F equals 212°F.

Dim tempC1 As New TemperatureCelsius(0)
Dim tempF1 As TemperatureFahrenheit = CType(Convert.ChangeType(tempC1, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempC1, tempF1)
Dim tempC2 As TemperatureCelsius = CType(Convert.ChangeType(tempC1, GetType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempC1, tempC2)
Dim tempF2 As New TemperatureFahrenheit(212)
Dim tempC3 As TEmperatureCelsius = CType(Convert.ChangeType(tempF2, GEtType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempF2, tempC3)
Dim tempF3 As TemperatureFahrenheit = CType(Convert.ChangeType(tempF2, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempF2, tempF3)
' The example displays the following output:
'       0°C equals 32°F.
'       0°C equals 0°C.
'       212°F equals 100°C.
'       212°F equals 212°F.

A TypeConverter osztály

A .NET lehetővé teszi egy egyéni típus típuskonverterének definiálását az osztály kibővítésével System.ComponentModel.TypeConverter és a típuskonverter attribútumon keresztüli System.ComponentModel.TypeConverterAttribute társításával. Az alábbi táblázat kiemeli a megközelítés és az IConvertible egyéni típusú felület implementálása közötti különbségeket.

Feljegyzés

Az egyéni típusokhoz csak akkor nyújtható tervezési idő támogatás, ha rendelkezik hozzá definiált típuskonverterrel.

Átalakítás TypeConverterrel	Átalakítás az IConvertible használatával
Egyéni típushoz egy külön osztály származtatásával valósítható meg TypeConverter. Ez a származtatott osztály attribútum alkalmazásával TypeConverterAttribute társítva van az egyéni típushoz.	A konvertálás végrehajtásához egyéni típus implementálható. A típus felhasználója egy konverziós IConvertible módszert hív meg a típuson.
A tervezéskor és futásidőben is használható.	Csak futásidőben használható.
Tükröződést használ; ezért lassabb, mint IConvertiblea .	Nem használ tükröződést.
Lehetővé teszi a kétirányú átalakítást az egyéni típusról más adattípusokra, más adattípusokról pedig az egyéni típusra. Például egy definiált TypeConverter beállítás lehetővé teszi a MyType konvertálást a helyről StringMyTypeStringa ra.MyType	Lehetővé teszi az egyéni típusról más adattípusokra való konvertálást, más adattípusokból azonban nem az egyéni típusba.

További információ a típuskonverterek konverziók végrehajtásához való használatáról: System.ComponentModel.TypeConverter.

Lásd még

• System.Convert
• IConvertible
• Típuskonvertálási táblák