Partager via

Conversion de type dans .NET

Chaque valeur a un type associé, qui définit des attributs tels que la quantité d’espace allouée à la valeur, la plage des valeurs possibles qu’elle peut avoir et les membres qu’il met à disposition. De nombreuses valeurs peuvent être exprimées sous la forme de plusieurs types. Par exemple, la valeur 4 peut être exprimée sous la forme d’un entier ou d’une valeur à virgule flottante. La conversion de type crée une valeur dans un nouveau type équivalent à la valeur d’un ancien type, mais ne conserve pas nécessairement l’identité (ou la valeur exacte) de l’objet d’origine.

.NET prend automatiquement en charge les conversions suivantes :

  • Conversion d’une classe dérivée en classe de base. Cela signifie, par exemple, qu’une instance de n’importe quelle classe ou structure peut être convertie en instance Object . Cette conversion ne nécessite pas d’opérateur de conversion ou de cast.

  • Conversion d’une classe de base vers la classe dérivée d’origine. En C#, cette conversion nécessite un opérateur de cast. En Visual Basic, il nécessite l’opérateur CType s’il Option Strict est activé.

  • Conversion à partir d’un type qui implémente une interface vers un objet d’interface qui représente cette interface. Cette conversion ne nécessite pas d’opérateur de conversion ou de cast.

  • Conversion d’un objet d’interface vers le type d’origine qui implémente cette interface. En C#, cette conversion nécessite un opérateur de cast. En Visual Basic, il nécessite l’opérateur CType s’il Option Strict est activé.

En plus de ces conversions automatiques, .NET fournit plusieurs fonctionnalités qui prennent en charge la conversion de type personnalisée. Ces options en question sont les suivantes :

Conversion implicite avec l’opérateur implicite

Les conversions étendues impliquent la création d’une nouvelle valeur à partir de la valeur d’un type existant qui a une plage plus restrictive ou une liste de membres plus restreinte que le type cible. L’élargissement des conversions ne peut pas entraîner de perte de données (bien qu’elles puissent entraîner une perte de précision). Étant donné que les données ne peuvent pas être perdues, les compilateurs peuvent gérer la conversion implicitement ou de manière transparente, sans nécessiter l’utilisation d’une méthode de conversion explicite ou d’un opérateur de cast.

Remarque

Bien que le code qui effectue une conversion implicite puisse appeler une méthode de conversion ou utiliser un opérateur de cast, son utilisation n’est pas requise par les compilateurs qui prennent en charge les conversions implicites.

Par exemple, le Decimal type prend en charge les conversions implicites à partir de Byte, Char, Int16, Int32, Int64, SByte, UInt16, UInt32 et UInt64 valeurs. L’exemple suivant illustre certaines de ces conversions implicites dans l’affectation de valeurs à une Decimal variable.

  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.

Si un compilateur de langage particulier prend en charge les opérateurs personnalisés, vous pouvez également définir des conversions implicites dans vos propres types personnalisés. L’exemple suivant fournit une implémentation partielle d’un type de données d’octet signé nommé ByteWithSign qui utilise la représentation de sign-and-magnitude. Il prend en charge la conversion implicite des valeurs Byte et SByte en valeurs 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

Le code client peut ensuite déclarer une ByteWithSign variable et lui attribuer les valeurs Byte et SByte sans effectuer de conversions explicites ou utiliser des opérateurs de conversion, comme le montre l'exemple suivant.

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

Conversion explicite avec l'opérateur Explicit

Les conversions restrictives impliquent la création d’une nouvelle valeur à partir de la valeur d’un type existant qui a une plage supérieure ou une liste de membres plus grande que le type cible. Étant donné qu’une conversion restrictive peut entraîner une perte de données, les compilateurs nécessitent souvent que la conversion soit rendue explicite par le biais d’un appel à une méthode de conversion ou à un opérateur de cast. Autrement dit, la conversion doit être gérée explicitement dans le code du développeur.

Remarque

Exiger une méthode de conversion ou un opérateur de cast pour les conversions restrictives a pour principal objectif que le développeur soit conscient des risques de perte de données ou d'un OverflowException et puisse les gérer dans le code. Toutefois, certains compilateurs peuvent assouplir cette exigence. Par exemple, dans Visual Basic, si Option Strict est désactivé (paramètre par défaut), le compilateur Visual Basic tente d'effectuer des conversions de type rétrécissant implicitement.

Par exemple, les types de données UInt32, Int64 et UInt64 ont des plages qui dépassent celles du type de données Int32, comme le montre le tableau suivant.

Catégorie Comparaison avec la plage d’Int32
Int64 Int64.MaxValue est supérieur à Int32.MaxValue, et Int64.MinValue est inférieur à (a une plage négative plus grande que) Int32.MinValue.
UInt32 UInt32.MaxValue est supérieur à Int32.MaxValue.
UInt64 UInt64.MaxValue est supérieur à Int32.MaxValue.

Pour gérer ces conversions étroites, .NET permet aux types de définir un Explicit opérateur. Les compilateurs de langage individuels peuvent ensuite implémenter cet opérateur à l’aide de leur propre syntaxe, ou un membre de la Convert classe peut être appelé pour effectuer la conversion. (Pour plus d’informations sur la Convert classe, consultez La classe Convert plus loin dans cette rubrique.) L’exemple suivant illustre l’utilisation de fonctionnalités de langage pour gérer la conversion explicite de ces valeurs entières hors plage en valeurs Int32 .

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: {number1} exceeds {int.MaxValue}.");
    else
        Console.WriteLine($"Conversion failed: {number1} is less than {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: {number2} exceeds {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: {number1} exceeds {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.

Les conversions explicites peuvent produire des résultats différents dans différentes langues, et ces résultats peuvent différer de la valeur retournée par la méthode correspondante Convert . Par exemple, si la valeur Double 12.63251 est convertie en Int32, la méthode CInt Visual Basic et la méthode Convert.ToInt32(Double) .NET arrondissent toutes les deux Double pour retourner la valeur 13, mais l'opérateur (int) C# tronque Double pour retourner la valeur 12. De même, l’opérateur C# (int) ne prend pas en charge la conversion booléenne en entier, mais la méthode Visual Basic CInt convertit une valeur de true en -1. En revanche, la méthode Convert.ToInt32(Boolean) convertit une valeur true en 1.

La plupart des compilateurs permettent d’effectuer des conversions explicites de manière vérifiée ou non vérifiée. Lorsqu'une conversion contrôlée est effectuée, un OverflowException est levé lorsque la valeur du type à convertir se situe hors de la plage du type cible. Lorsqu’une conversion non vérifiée est effectuée dans les mêmes conditions, la conversion peut ne pas lever d’exception, mais le comportement exact n’est pas défini et une valeur incorrecte peut se produire.

Remarque

En C#, les conversions vérifiées peuvent être effectuées à l’aide du mot clé checked avec un opérateur de conversion ou en spécifiant l’option de compilation /checked+. À l'inverse, les conversions non vérifiées peuvent être effectuées à l'aide du mot-clé unchecked avec l'opérateur de conversion ou en spécifiant l'option de compilation /checked-. Par défaut, les conversions explicites sont désactivées. Dans Visual Basic, les conversions cochées peuvent être effectuées en désactivant la case à cocher Supprimer le dépassement d’entier dans la boîte de dialogue Paramètres du compilateur avancés du projet ou en spécifiant l’option du /removeintchecks- compilateur. À l'inverse, les conversions non vérifiées peuvent être effectuées en sélectionnant la case à cocher Supprimer le dépassement d'entier dans la boîte de dialogue des Paramètres avancés du compilateur du projet ou en spécifiant l'option du /removeintchecks+ compilateur. Par défaut, les conversions explicites sont vérifiées.

L’exemple en C# suivant utilise les mots clés checked et unchecked pour illustrer la différence de comportement lorsqu’une valeur en dehors de la plage de Byte est convertie en Byte. La conversion vérifiée lève une exception, mais la conversion non cochée affecte Byte.MaxValue à la Byte variable.

int largeValue = Int32.MaxValue;
byte newValue;

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

try
{
    newValue = checked((byte)largeValue);
    Console.WriteLine($"Converted the {largeValue.GetType().Name} value {largeValue} to the {newValue.GetType().Name} value {newValue}.");
}
catch (OverflowException)
{
    Console.WriteLine($"{largeValue} is outside the range of the Byte data type.");
}
// 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.

Si un compilateur de langage particulier prend en charge les opérateurs surchargés personnalisés, vous pouvez également définir des conversions explicites dans vos propres types personnalisés. L’exemple suivant fournit une implémentation partielle d’un type de données d’octet signé nommé ByteWithSign qui utilise la représentation de sign-and-magnitude. Il prend en charge la conversion explicite des valeurs Int32 et UInt32 en valeurs ByteWithSign.

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

Le code client peut ensuite déclarer une ByteWithSign variable et lui assigner les valeurs Int32 et UInt32 si les affectations incluent un opérateur de cast ou une méthode de conversion, comme l’illustre l’exemple suivant.

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.

Interface IConvertible

Pour prendre en charge la conversion de n’importe quel type en type de base Common Language Runtime, .NET fournit l’interface IConvertible . Le type d’implémentation est requis pour fournir les éléments suivants :

  • Une méthode qui retourne le TypeCode du type implémenté.

  • Méthodes pour convertir le type d’implémentation en chaque type de base Common Language Runtime (Boolean, , ByteDateTime, Decimal, Doubleetc.).

  • Méthode de conversion généralisée pour convertir une instance du type d’implémentation en un autre type spécifié. Les conversions qui ne sont pas prises en charge doivent lever un InvalidCastException.

Chaque type de base de la common language runtime (c'est-à-dire, le Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32, et UInt64), ainsi que les types DBNull et Enum, implémente l’interface IConvertible. Toutefois, il s’agit d’implémentations d’interface explicites ; la méthode de conversion ne peut être appelée qu’à l’aide d’une variable d’interface IConvertible , comme l’illustre l’exemple suivant. Cet exemple convertit une Int32 valeur en sa valeur équivalente Char .

int codePoint = 1067;
IConvertible iConv = codePoint;
char ch = iConv.ToChar(null);
Console.WriteLine($"Converted {codePoint} to {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)

L’exigence d’appeler la méthode de conversion sur son interface plutôt que sur le type d’implémentation rend les implémentations d’interface explicites relativement coûteuses. Au lieu de cela, nous vous recommandons d’appeler le membre approprié de la classe Convert pour effectuer la conversion entre les types de base Common Language Runtime. Pour plus d’informations, consultez la section suivante, The Convert Class.

Remarque

Outre l’interface et la IConvertibleConvert classe fournie par .NET, les langues individuelles peuvent également fournir des moyens d’effectuer des conversions. Par exemple, C# utilise des opérateurs de cast ; Visual Basic utilise des fonctions de conversion implémentées par le compilateur telles que CType, CIntet DirectCast.

Pour la plupart, l’interface IConvertible est conçue pour prendre en charge la conversion entre les types de base dans .NET. Toutefois, l’interface peut également être implémentée par un type personnalisé pour prendre en charge la conversion de ce type en d’autres types personnalisés. Pour plus d’informations, consultez la section Conversions personnalisées avec la méthode ChangeType plus loin dans cette rubrique.

Classe Convert

Bien que l'implémentation de l'interface de chaque type de base IConvertible puisse être appelée pour effectuer une conversion de type, l'appel des méthodes de la classe System.Convert est la méthode neutre en langage recommandée pour convertir d'un type de base à un autre. En outre, la Convert.ChangeType(Object, Type, IFormatProvider) méthode peut être utilisée pour convertir un type personnalisé spécifié en un autre type.

Conversions entre types de base

La Convert classe fournit un moyen neutre en langage d’effectuer des conversions entre les types de base et est disponible pour toutes les langues qui ciblent le Common Language Runtime. Il fournit un ensemble complet de méthodes pour l’élargissement et la réduction des conversions, et lève un InvalidCastException pour les conversions qui ne sont pas prises en charge (par exemple, la conversion d’une DateTime valeur en valeur entière). Les conversions restrictives sont effectuées dans un contexte vérifié (checked), et un OverflowException est levé en cas d'échec de la conversion.

Importante

Étant donné que la Convert classe inclut des méthodes de conversion vers et à partir de chaque type de base, elle élimine la nécessité d’appeler l’implémentation d’interface explicite de chaque type de IConvertible base.

L’exemple suivant illustre l’utilisation de la System.Convert classe pour effectuer plusieurs conversions étendues et étroites entre les types de base .NET.

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

// 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 {doubleValue.GetType().Name} value {doubleValue:E} to " +
                                      "the {longValue.GetType().Name} value {longValue:N0}.");
}
catch (OverflowException)
{
    Console.WriteLine($"Unable to convert the {doubleValue.GetType().Name:E} value {doubleValue}.");
}

// Convert a signed byte to a byte (a narrowing conversion).
sbyte sbyteValue = -16;
try
{
    byte byteValue2 = Convert.ToByte(sbyteValue);
    Console.WriteLine($"Converted the {sbyteValue.GetType().Name} value {sbyteValue} to " +
                                      "the {byteValue2.GetType().Name} value {byteValue2:G}.");
}
catch (OverflowException)
{
    Console.WriteLine($"Unable to convert the {sbyteValue.GetType().Name} value {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.

Dans certains cas, en particulier lors de la conversion vers et depuis des nombres à virgule flottante, une conversion peut impliquer une perte de précision, même si elle ne génère pas OverflowException. L’exemple suivant illustre cette perte de précision. Dans le premier cas, une Decimal valeur a moins de précision (moins de chiffres significatifs) lorsqu’elle est convertie en Double. Dans le deuxième cas, une Double valeur est arrondie de 42,72 à 43 pour terminer la conversion.

double doubleValue;

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

doubleValue = 42.72;
try
{
    int integerValue = Convert.ToInt32(doubleValue);
    Console.WriteLine($"{doubleValue} converted to {integerValue}.");
}
catch (OverflowException)
{
    Console.WriteLine($"Unable to convert {doubleValue} to an integer.");
}
// 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.

Pour obtenir une table qui répertorie à la fois les conversions étendues et étroites prises en charge par la Convert classe, consultez Tables de conversion de type.

Conversions personnalisées avec la méthode ChangeType

Outre la prise en charge des conversions vers chacun des types de base, la Convert classe peut être utilisée pour convertir un type personnalisé en un ou plusieurs types prédéfinis. Cette conversion est effectuée par la Convert.ChangeType(Object, Type, IFormatProvider) méthode, qui encapsule à son tour un appel à la IConvertible.ToType méthode du value paramètre. Cela signifie que l’objet représenté par le value paramètre doit fournir une implémentation de l’interface IConvertible .

Remarque

Étant donné que les méthodes Convert.ChangeType(Object, Type) et Convert.ChangeType(Object, Type, IFormatProvider) utilisent un objet Type pour spécifier le type cible vers lequel value est converti, elles peuvent être utilisées pour effectuer une conversion dynamique vers un objet dont le type n’est pas connu au moment de la compilation. Toutefois, notez que l’implémentation IConvertible de value doit toujours prendre en charge cette conversion.

L’exemple suivant illustre une implémentation possible de l’interface IConvertible qui permet à un TemperatureCelsius objet d’être converti en objet TemperatureFahrenheit et inversement. L’exemple définit une classe de base, Temperaturequi implémente l’interface IConvertible et remplace la Object.ToString méthode. Les classes dérivées TemperatureCelsius et TemperatureFahrenheit surchargent chacune les méthodes ToType et ToString de la classe de base.

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

L’exemple suivant illustre plusieurs appels à ces IConvertible implémentations pour convertir TemperatureCelsius des objets en TemperatureFahrenheit objets et inversement.

TemperatureCelsius tempC1 = new TemperatureCelsius(0);
TemperatureFahrenheit tempF1 = (TemperatureFahrenheit)Convert.ChangeType(tempC1, typeof(TemperatureFahrenheit), null);
Console.WriteLine($"{tempC1} equals {tempF1}.");
TemperatureCelsius tempC2 = (TemperatureCelsius)Convert.ChangeType(tempC1, typeof(TemperatureCelsius), null);
Console.WriteLine($"{tempC1} equals {tempC2}.");
TemperatureFahrenheit tempF2 = new TemperatureFahrenheit(212);
TemperatureCelsius tempC3 = (TemperatureCelsius)Convert.ChangeType(tempF2, typeof(TemperatureCelsius), null);
Console.WriteLine($"{tempF2} equals {tempC3}.");
TemperatureFahrenheit tempF3 = (TemperatureFahrenheit)Convert.ChangeType(tempF2, typeof(TemperatureFahrenheit), null);
Console.WriteLine($"{tempF2} equals {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.

Classe TypeConverter

.NET vous permet également de définir un convertisseur de type pour un type personnalisé en étendant la System.ComponentModel.TypeConverter classe et en associant le convertisseur de type au type via un System.ComponentModel.TypeConverterAttribute attribut. Le tableau suivant met en évidence les différences entre cette approche et l’implémentation de l’interface IConvertible pour un type personnalisé.

Remarque

La prise en charge au moment du design ne peut être fournie pour un type personnalisé que si un convertisseur de type est défini pour ce dernier.

Conversion à l’aide de TypeConverter Conversion à l’aide d’IConvertible
Est implémenté pour un type personnalisé en dérivant une classe distincte de TypeConverter. Cette classe dérivée est associée au type personnalisé en appliquant un TypeConverterAttribute attribut. Est implémentée par un type personnalisé pour effectuer la conversion. Un utilisateur du type appelle une méthode de conversion IConvertible sur le type.
Peut être utilisé à la fois au moment du design et au moment de l’exécution. Ne peut être utilisée qu'au moment de l'exécution.
Utilise la réflexion ; par conséquent, est plus lent que la conversion activée par IConvertible. N’utilise pas la réflexion.
Autorise les conversions de types bidirectionnelles du type personnalisé vers d'autres types de données et d'autres types de données vers le type personnalisé. Par exemple, un TypeConverter défini pour le MyType autorisent les conversions de MyType vers String, et de String vers MyType. Autorise la conversion d’un type personnalisé vers d’autres types de données, mais pas d’autres types de données vers le type personnalisé.

Pour plus d’informations sur l’utilisation de convertisseurs de types pour effectuer des conversions, consultez System.ComponentModel.TypeConverter.

Voir aussi