Typeconversie in .NET

  • Artikel

Elke waarde heeft een gekoppeld type, dat kenmerken definieert, zoals de hoeveelheid ruimte die aan de waarde is toegewezen, het bereik van mogelijke waarden die deze kan hebben en de leden die deze beschikbaar maakt. Veel waarden kunnen worden uitgedrukt als meer dan één type. De waarde 4 kan bijvoorbeeld worden uitgedrukt als een geheel getal of een drijvende-kommawaarde. Typeconversie maakt een waarde in een nieuw type dat gelijk is aan de waarde van een oud type, maar behoudt niet noodzakelijkerwijs de identiteit (of exacte waarde) van het oorspronkelijke object.

.NET ondersteunt automatisch de volgende conversies:

  • Conversie van een afgeleide klasse naar een basisklasse. Dit betekent bijvoorbeeld dat een exemplaar van een klasse of structuur kan worden geconverteerd naar een Object exemplaar. Voor deze conversie is geen cast- of conversieoperator vereist.

  • Conversie van een basisklasse terug naar de oorspronkelijke afgeleide klasse. Voor deze conversie in C# is een cast-operator vereist. In Visual Basic is de CType operator vereist als Option Strict deze is ingeschakeld.

  • Conversie van een type dat een interface implementeert naar een interfaceobject dat die interface vertegenwoordigt. Voor deze conversie is geen cast- of conversieoperator vereist.

  • Conversie van een interfaceobject terug naar het oorspronkelijke type dat die interface implementeert. Voor deze conversie in C# is een cast-operator vereist. In Visual Basic is de CType operator vereist als Option Strict deze is ingeschakeld.

Naast deze automatische conversies biedt .NET verschillende functies die ondersteuning bieden voor conversie van aangepaste typen. Dit zijn onder meer de volgende:

Impliciete conversie met de impliciete operator

Bij het breder maken van conversies wordt een nieuwe waarde gemaakt op basis van de waarde van een bestaand type met een meer beperkend bereik of een meer beperkte ledenlijst dan het doeltype. Het breder maken van conversies kan niet leiden tot gegevensverlies (hoewel dit kan leiden tot een verlies van precisie). Omdat gegevens niet verloren kunnen gaan, kunnen compilers de conversie impliciet of transparant verwerken zonder dat hiervoor een expliciete conversiemethode of een cast-operator nodig is.

Notitie

Hoewel code die een impliciete conversie uitvoert een conversiemethode kan aanroepen of een cast-operator kan gebruiken, is het gebruik ervan niet vereist voor compilers die impliciete conversies ondersteunen.

Het type ondersteunt bijvoorbeeld Decimal impliciete conversies van Byte, Char, Int16, , Int32, Int64, SByte, UInt16, en UInt32UInt64 waarden. In het volgende voorbeeld ziet u enkele van deze impliciete conversies bij het toewijzen van waarden aan een Decimal variabele.

  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.

Als een bepaalde taalcompilator aangepaste operators ondersteunt, kunt u ook impliciete conversies definiëren in uw eigen aangepaste typen. Het volgende voorbeeld bevat een gedeeltelijke implementatie van een ondertekend bytegegevenstype met de naam ByteWithSign die gebruikmaakt van een teken- en grootteweergave. Het ondersteunt impliciete conversie van Byte en SByte waarden naar ByteWithSign waarden.

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

Clientcode kan vervolgens een ByteWithSign variabele declareren en deze en SByte waarden toewijzen Byte zonder expliciete conversies uit te voeren of cast-operators te gebruiken, zoals in het volgende voorbeeld wordt weergegeven.

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

Expliciete conversie met de expliciete operator

Bij het beperken van conversies wordt een nieuwe waarde gemaakt op basis van de waarde van een bestaand type met een groter bereik of een grotere ledenlijst dan het doeltype. Omdat een narrowing conversie kan leiden tot verlies van gegevens, vereisen compilers vaak dat de conversie expliciet wordt gemaakt via een aanroep naar een conversiemethode of een cast-operator. Dat wil gezegd, de conversie moet expliciet worden verwerkt in ontwikkelaarscode.

Notitie

Het belangrijkste doel van het vereisen van een conversiemethode of cast-operator voor het beperken van conversies is om de ontwikkelaar bewust te maken van de mogelijkheid van gegevensverlies of een OverflowException zodanig dat deze in code kan worden verwerkt. Sommige compilers kunnen deze vereiste echter versoepelen. Als visual Basic Option Strict bijvoorbeeld is uitgeschakeld (de standaardinstelling), probeert de Visual Basic-compiler impliciet smallere conversies uit te voeren.

De gegevenstypen en UInt64Int64gegevenstypen bevatten bijvoorbeeld UInt32bereiken die groter zijn dan het Int32 gegevenstype, zoals in de volgende tabel wordt weergegeven.

Type Vergelijking met het bereik van Int32
Int64 Int64.MaxValue is groter dan Int32.MaxValue, en Int64.MinValue is kleiner dan (heeft een groter negatief bereik dan) Int32.MinValue.
UInt32 UInt32.MaxValue is groter dan Int32.MaxValue.
UInt64 UInt64.MaxValue is groter dan Int32.MaxValue.

Als u dergelijke narrowing-conversies wilt verwerken, kunt u met .NET typen een Explicit operator definiëren. Afzonderlijke taalcompilers kunnen deze operator vervolgens implementeren met hun eigen syntaxis, of een lid van de Convert klasse kan worden aangeroepen om de conversie uit te voeren. (Zie De klasse Converteren verderop in dit onderwerp voor meer informatie over de Convert klasse.) In het volgende voorbeeld ziet u het gebruik van taalfuncties voor het afhandelen van de expliciete conversie van deze mogelijk buitenbereik gehele getallen naar Int32 waarden.

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.

Expliciete conversies kunnen verschillende resultaten produceren in verschillende talen en deze resultaten kunnen verschillen van de waarde die wordt geretourneerd door de bijbehorende Convert methode. Als de waarde 12.63251 bijvoorbeeld wordt geconverteerd naar een Int32, rondt de Visual Basic-methode CInt en de .NET-methode Convert.ToInt32(Double) de Double waarde af om een waarde van 13 te retourneren, maar de C#(int)-operator kapt de Double waarde af om een waarde van 12 te retourneren.Double Op dezelfde manier biedt de C# (int) -operator geen ondersteuning voor conversie van Booleaanse waarde naar geheel getal, maar converteert de Visual Basic-methode CInt een waarde van true -1. Aan de andere kant converteert de Convert.ToInt32(Boolean) methode een waarde van true 1.

In de meeste compilers kunnen expliciete conversies op een ingeschakelde of niet-gecontroleerde manier worden uitgevoerd. Wanneer een gecontroleerde conversie wordt uitgevoerd, wordt er een OverflowException gegenereerd wanneer de waarde van het type dat moet worden geconverteerd buiten het bereik van het doeltype valt. Wanneer een niet-gecontroleerd conversie wordt uitgevoerd onder dezelfde omstandigheden, genereert de conversie mogelijk geen uitzondering, maar wordt het exacte gedrag niet gedefinieerd en kan een onjuiste waarde resulteren.

Notitie

In C# kunnen gecontroleerde conversies worden uitgevoerd met behulp van het checked trefwoord samen met een cast-operator of door de /checked+ compileroptie op te geven. Omgekeerd kunnen niet-ingeschakelde conversies worden uitgevoerd met behulp van het unchecked trefwoord samen met de cast-operator of door de /checked- compileroptie op te geven. Expliciete conversies worden standaard uitgeschakeld. In Visual Basic kunnen ingeschakelde conversies worden uitgevoerd door het selectievakje Overloop van gehele getallen verwijderen uit te schakelen in het dialoogvenster Geavanceerde compiler van het project Instellingen of door de /removeintchecks- optie compiler op te geven. Omgekeerd kunnen niet-ingeschakelde conversies worden uitgevoerd door het selectievakje Overloop van gehele getallen verwijderen in het dialoogvenster Geavanceerde compiler van het project Instellingen in te schakelen of door de /removeintchecks+ optie compiler op te geven. Standaard worden expliciete conversies gecontroleerd.

In het volgende C#-voorbeeld worden de checked en unchecked trefwoorden gebruikt om het verschil in gedrag te illustreren wanneer een waarde buiten het bereik van een Byte wordt geconverteerd naar een Byte. De gecontroleerde conversie genereert een uitzondering, maar de niet-gecontroleerde conversie wordt Byte.MaxValue toegewezen aan de Byte variabele.

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.

Als een bepaalde taalcompilator aangepaste overbelaste operators ondersteunt, kunt u ook expliciete conversies definiëren in uw eigen aangepaste typen. Het volgende voorbeeld bevat een gedeeltelijke implementatie van een ondertekend bytegegevenstype met de naam ByteWithSign die gebruikmaakt van een teken- en grootteweergave. Het ondersteunt expliciete conversie van Int32 en UInt32 waarden naar ByteWithSign waarden.

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

Clientcode kan vervolgens een ByteWithSign variabele declareren en deze en UInt32 waarden toewijzen Int32 als de toewijzingen een cast-operator of een conversiemethode bevatten, zoals in het volgende voorbeeld wordt weergegeven.

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.

De IConvertible-interface

.NET biedt de interface om de conversie van elk type naar een algemeen runtime-basistype voor taal te IConvertible ondersteunen. Het implementatietype is vereist om het volgende op te geven:

  • Een methode die het TypeCode implementatietype retourneert.

  • Methoden voor het converteren van het implementatietype naar elk basistype voor runtime van de algemene taal (Boolean, ByteDateTime, Decimal, Doubleenzovoort).

  • Een gegeneraliseerde conversiemethode om een exemplaar van het implementatietype te converteren naar een ander opgegeven type. Conversies die niet worden ondersteund, moeten een InvalidCastException.

Elk algemene basistype van de taalruntime (dat wil gezegd, de , , , Int32StringDecimalDateTimeDoubleUInt16Int64SByteInt16SingleUInt32Charen UInt64) evenals de DBNull en Enum typen, implementeren de IConvertible interface. ByteBoolean Dit zijn echter expliciete interface-implementaties; de conversiemethode kan alleen worden aangeroepen via een IConvertible interfacevariabele, zoals in het volgende voorbeeld wordt weergegeven. In dit voorbeeld wordt een Int32 waarde geconverteerd naar de equivalente Char waarde.

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)

De vereiste om de conversiemethode op de interface aan te roepen in plaats van op het implementatietype, maakt expliciete interface-implementaties relatief duur. In plaats daarvan raden we u aan het juiste lid van de Convert klasse aan te roepen om te converteren tussen algemene runtime-basistypen voor taal. Zie de volgende sectie, The Convert Class, voor meer informatie.

Notitie

Naast de IConvertible interface en de Convert klasse die door .NET wordt geleverd, kunnen afzonderlijke talen ook manieren bieden om conversies uit te voeren. C# maakt bijvoorbeeld gebruik van cast-operators; Visual Basic maakt gebruik van door compiler geïmplementeerde conversiefuncties zoals CType, CInten DirectCast.

Voor het grootste deel is de IConvertible interface ontworpen ter ondersteuning van conversie tussen de basistypen in .NET. De interface kan echter ook worden geïmplementeerd door een aangepast type ter ondersteuning van de conversie van dat type naar andere aangepaste typen. Zie de sectie Aangepaste conversies met de ChangeType-methode verderop in dit onderwerp voor meer informatie.

De klasse Converteren

Hoewel de interface-implementatie van IConvertible elk basistype kan worden aangeroepen om een typeconversie uit te voeren, is het aanroepen van de methoden van de System.Convert klasse de aanbevolen taalneutrale manier om van het ene basistype naar het andere te converteren. Daarnaast kan de Convert.ChangeType(Object, Type, IFormatProvider) methode worden gebruikt om te converteren van een opgegeven aangepast type naar een ander type.

Conversies tussen basistypen

De Convert klasse biedt een taalneutrale manier om conversies uit te voeren tussen basistypen en is beschikbaar voor alle talen die gericht zijn op de algemene taalruntime. Het biedt een volledige set methoden voor zowel widening als narrowing conversies, en genereert een InvalidCastException voor conversies die niet worden ondersteund (zoals de conversie van een DateTime waarde naar een geheel getal). Vermalingsconversies worden uitgevoerd in een gecontroleerde context en er wordt een OverflowException gegenereerd als de conversie mislukt.

Belangrijk

Omdat de Convert klasse methoden bevat om te converteren naar en van elk basistype, is het niet meer nodig om de expliciete interface-implementatie van IConvertible elk basistype aan te roepen.

In het volgende voorbeeld ziet u het gebruik van de System.Convert klasse om verschillende verbrekings- en narrowingconversies tussen .NET-basistypen uit te voeren.

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

In sommige gevallen, met name bij het converteren naar en van drijvendekommawaarden, kan een conversie leiden tot verlies van precisie, zelfs als er geen OverflowException. In het volgende voorbeeld ziet u dit verlies van precisie. In het eerste geval heeft een Decimal waarde minder precisie (minder significante cijfers) wanneer deze wordt geconverteerd naar een Double. In het tweede geval wordt een Double waarde afgerond van 42,72 tot 43 om de conversie te voltooien.

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.

Zie Typeconversietabellen voor een tabel met de verbrekings- en narrowingconversies die door de Convert klasse worden ondersteund.

Aangepaste conversies met de Methode ChangeType

Naast ondersteunende conversies naar elk van de basistypen, kan de Convert klasse worden gebruikt om een aangepast type te converteren naar een of meer vooraf gedefinieerde typen. Deze conversie wordt uitgevoerd door de Convert.ChangeType(Object, Type, IFormatProvider) methode, die op zijn beurt een aanroep naar de IConvertible.ToType methode van de value parameter verpakt. Dit betekent dat het object dat wordt vertegenwoordigd door de value parameter een implementatie van de IConvertible interface moet bieden.

Notitie

Omdat de Convert.ChangeType(Object, Type) en Convert.ChangeType(Object, Type, IFormatProvider) methoden een Type object gebruiken om het doeltype op te geven waarnaar value wordt geconverteerd, kunnen ze worden gebruikt om een dynamische conversie uit te voeren naar een object waarvan het type niet bekend is tijdens het compileren. Houd er echter rekening mee dat de IConvertible implementatie van value deze conversie nog steeds moet worden ondersteund.

In het volgende voorbeeld ziet u een mogelijke implementatie van de IConvertible interface waarmee een TemperatureCelsius object kan worden geconverteerd naar een TemperatureFahrenheit object en omgekeerd. In het voorbeeld wordt een basisklasse gedefinieerd, Temperaturewaarmee de IConvertible interface wordt geïmplementeerd en de Object.ToString methode wordt overschreven. De afgeleide TemperatureCelsius en TemperatureFahrenheit klassen overschrijven de ToType en de ToString methoden van de basisklasse.

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

In het volgende voorbeeld ziet u verschillende aanroepen naar deze IConvertible implementaties om objecten te converteren TemperatureCelsius naar TemperatureFahrenheit objecten en omgekeerd.

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.

De Klasse TypeConverter

Met .NET kunt u ook een typeconversieprogramma voor een aangepast type definiëren door de System.ComponentModel.TypeConverter klasse uit te breiden en het typeconversieprogramma te koppelen aan het type via een System.ComponentModel.TypeConverterAttribute kenmerk. In de volgende tabel worden de verschillen tussen deze benadering en de implementatie van de IConvertible interface voor een aangepast type gemarkeerd.

Notitie

Ontwerptijdondersteuning kan alleen worden geboden voor een aangepast type als er een typeconversieprogramma voor is gedefinieerd.

Conversie met Behulp van Type Converter Conversie met IConvertible
Wordt geïmplementeerd voor een aangepast type door een afzonderlijke klasse af te leiden van TypeConverter. Deze afgeleide klasse is gekoppeld aan het aangepaste type door een TypeConverterAttribute kenmerk toe te passen. Wordt geïmplementeerd door een aangepast type om conversie uit te voeren. Een gebruiker van het type roept een IConvertible conversiemethode voor het type aan.
Kan zowel tijdens de ontwerptijd als tijdens runtime worden gebruikt. Kan alleen tijdens runtime worden gebruikt.
Gebruikt reflectie; is daarom langzamer dan de conversie is ingeschakeld door IConvertible. Gebruikt geen weerspiegeling.
Hiermee kunt u conversies in twee richtingen van het aangepaste type naar andere gegevenstypen en van andere gegevenstypen naar het aangepaste type toestaan. Een TypeConverter gedefinieerde voor MyType bijvoorbeeld conversies van MyType naar String, en van String naar MyType. Hiermee staat u conversie toe van een aangepast type naar andere gegevenstypen, maar niet van andere gegevenstypen naar het aangepaste type.

Zie voor meer informatie over het gebruik van typeconversieprogramma's om conversies System.ComponentModel.TypeConverteruit te voeren.

Zie ook