Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Conversión de tipos en .NET Framework

Cada valor tiene un tipo asociado, que define atributos como la cantidad de espacio asignado al valor, el intervalo de valores posibles que puede tener y los miembros que ofrece. Muchos valores se pueden expresar como más de un tipo. Por ejemplo, el valor 4 se puede expresar como un entero o como un valor de punto flotante. La conversión de tipo crea un valor en un nuevo tipo que es equivalente al valor de un tipo antiguo, pero no conserva necesariamente la identidad (o valor exacto) del objeto original.

.NET Framework proporciona varias características que admiten la conversión de tipo. Entre ellas se incluyen las siguientes:

Las conversiones de ampliación implican la creación de un nuevo valor a partir del valor de un tipo existente que tiene un intervalo más restrictivo o una lista de miembros más restringida que el tipo de destino. Las conversión de ampliación no pueden producir ninguna pérdida de datos (aunque pueden producir una pérdida de precisión). Puesto que no se pueden perder datos, los compiladores pueden administrar la conversión de manera implícita o transparente, sin que sea necesario el uso de un método de conversión explícito o de un operador de conversión.

Nota Nota

Aunque el código que realiza una conversión implícita puede llamar a un método de conversión o usar un operador de conversión, los compiladores que admiten las conversiones implícitas no necesitan usarlos.

Por ejemplo, el tipo Decimal admite conversiones implícitas a partir de valores Byte, Char, Int16, Int32, Int64, SByte, UInt16, UInt32 y UInt64. En el ejemplo siguiente se muestran algunas de estas conversiones implícitas al asignar valores a una variable Decimal.


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}.", 
                  longValue.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 Int64 value, the Decimal value is 18446744073709551615.


Si un compilador de un lenguaje determinado admite operadores personalizados, también puede definir conversiones implícitas en sus propios tipos personalizados. En el ejemplo siguiente se proporciona una implementación parcial de un tipo de datos de byte con signo denominado ByteWithSign que usa la representación de signo y magnitud. Admite la conversión implícita de valores SByte y Byte a valores 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();
   }
}


A continuación, el código de cliente puede declarar una variable ByteWithSign y asignarle valores SByte y Byte sin realizar ninguna conversión explícita ni emplear ningún operador de conversión, como se muestra en el ejemplo siguiente.


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


Volver al principio

Las conversiones de restricción implican la creación de un nuevo valor a partir del valor de un tipo existente que tiene un intervalo mayor o una lista de miembros mayor que el tipo de destino. Puesto que una conversión de restricción puede producir una pérdida de datos, los compiladores suelen necesitar que la conversión se haga explícita a través de una llamada a un método de conversión o a un operador de conversión. Es decir, la conversión se debe administrar explícitamente en el código de desarrollo.

Nota Nota

La finalidad principal de solicitar un método de conversión o un operador de conversión para las conversiones de restricción es que el desarrollador sea consciente de la posibilidad de que se pierdan datos o de que se produzca una excepción OverflowException, para que se pueda administrar en el código. Sin embargo, algunos compiladores pueden ser menos exigentes con este requisito. Por ejemplo, en Visual Basic, si Option Strict está desactivado (la configuración predeterminada), el compilador de Visual Basic intenta realizar las conversiones de restricción implícitamente.

Por ejemplo, los tipos de datos UInt32, Int64 y UInt64 tienen intervalos que superan el del tipo de datos Int32, como se muestra en la tabla siguiente.

Tipo

Comparación con el intervalo de Int32

Int64

Int64.MaxValue es mayor que Int32.MaxValue, y Int64.MinValue es menor que (tiene un intervalo negativo mayor que) Int32.MinValue.

UInt32

UInt32.MaxValue es mayor que Int32.MaxValue.

UInt64

UInt64.MaxValue es mayor que Int32.MaxValue.

Para administrar estas conversiones de restricción, .NET Framework permite que los tipos definan un operador Explicit. A continuación, los compiladores de lenguaje individuales pueden implementar este operador usando su propia sintaxis o se puede llamar a un miembro de la clase Convert para realizar la conversión. (Para obtener más información sobre la clase Convert, vea Clase Convert más adelante en este tema.) En el ejemplo siguiente se muestra el uso de las características de lenguaje para administrar la conversión explícita de estos valores enteros, que potencialmente están fuera del intervalo, a valores de tipo 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: {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.


Las conversiones explícitas pueden producir resultados diferentes en los distintos lenguajes y estos resultados pueden diferir del valor devuelto por el método Convert correspondiente. Por ejemplo, si el valor Double 12.63251 se convierte en Int32, el método CInt de Visual Basic y el método Convert.ToInt32(Double) de .NET Framework redondean el valor Double para devolver un valor de 13, pero el operador (int) de C# trunca Double para devolver un valor de 12. De manera similar, el operador (int) de C# no admite la conversión de booleano a entero, pero el método CInt de Visual Basic convierte un valor de true en -1. Por otra parte, el método Convert.ToInt32(Boolean) convierte un valor de true en 1.

La mayoría de los compiladores permiten realizar conversiones explícitas de manera comprobada o no comprobada. Cuando se realiza una conversión comprobada, se produce una excepción OverflowException si el valor del tipo que se va a convertir está fuera del intervalo del tipo de destino. Si se realiza una conversión no comprobada en las mismas condiciones, es posible que la conversión no produzca una excepción, pero no se podrá determinar con exactitud cuál será el comportamiento y se puede obtener como resultado un valor incorrecto.

Nota Nota

En C#, las conversiones comprobadas se pueden realizar usando la palabra clave checked junto con un operador de conversión o especificando la opción del compilador /checked+. Por el contrario, las conversiones no comprobadas se pueden realizar utilizando la palabra clave unchecked junto con el operador de conversión de tipo o especificando la opción del compilador /checked-. De forma predeterminada, las conversiones explícitas no se comprueban. En Visual Basic, las conversiones comprobadas se pueden realizar desactivando la casilla Quitar comprobaciones de desbordamiento con enteros en el cuadro de diálogo Configuración de compilador avanzada del proyecto o especificando la opción del compilador /removeintchecks-. Por el contrario, las conversiones no comprobadas se pueden realizar activando la casilla Quitar comprobaciones de desbordamiento con enteros en el cuadro de diálogo Configuración de compilador avanzada del proyecto o especificando la opción del compilador /removeintchecks+. De forma predeterminada, las conversiones explícitas se comprueban.

En el siguiente ejemplo de C# se usan las palabras clave unchecked y checked para mostrar la diferencia de comportamiento cuando un valor que está fuera del intervalo de Byte se convierte en Byte. La conversión comprobada produce una excepción, pero la conversión no comprobada asigna Byte.MaxValue a la variable Byte.


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.


Si un compilador de un lenguaje determinado admite operadores sobrecargados personalizados, también puede definir conversiones explícitas en sus propios tipos personalizados. En el ejemplo siguiente se proporciona una implementación parcial de un tipo de datos de byte con signo denominado ByteWithSign que usa la representación de signo y magnitud. Admite la conversión explícita de valores UInt32 y Int32 a valores ByteWithSign.


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

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

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

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

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

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

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


A continuación, el código de cliente puede declarar una variable ByteWithSign y asignarle valores de tipo Int32 y UInt32 si las asignaciones incluyen un operador de conversión o un método de conversión, como se muestra en el ejemplo siguiente.


ByteWithSign value;

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

try {
   uint uintValue = 1024;
   value = (ByteWithSign) 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 ByteWithSign data type.


Volver al principio

Para admitir la conversión de cualquier tipo en un tipo base de Common Language Runtime, .NET Framework proporciona la interfaz IConvertible. El tipo que se está implementando debe proporcionar lo siguiente:

  • Un método que devuelva el objeto TypeCode del tipo que se está implementando.

  • Métodos para convertir el tipo que se está implementando en cada uno de los tipos base de Common Language Runtime (Boolean, Byte, DateTime, Decimal, Double, etc.).

  • Un método de conversión generalizado para convertir una instancia del tipo que se está implementando en otro tipo concreto. Las conversiones que no se admiten deben iniciar una excepción InvalidCastException.

Cada uno de los tipos base de Common Language Runtime (es decir, Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32y UInt64), así como los tipos Enum y DBNull, implementan la interfaz IConvertible. Sin embargo, se trata de implementaciones de interfaz explícitas; solo se puede llamar al método de conversión mediante una variable de la interfaz IConvertible, como se muestra en el ejemplo siguiente. Este ejemplo convierte un valor Int32 en su valor Char equivalente.


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


El requisito de llamar al método de conversión en su interfaz, en lugar de en el tipo que se está implementando, hace que las implementaciones de interfaz explícitas resulten relativamente costosas. En su lugar, se recomienda llamar al miembro adecuado de la clase Convert para convertir entre los tipos base de Common Language Runtime. Para obtener más información, vea la próxima sección Clase Convert.

Nota Nota

Además de la interfaz IConvertible y la clase Convert proporcionadas por .NET Framework, los lenguajes individuales también pueden proporcionar maneras de realizar las conversiones. Por ejemplo, C# utiliza operadores de conversión, mientras que Visual Basic utiliza funciones de conversión implementadas por el compilador como CType, CInt y DirectCast.

En su mayor parte, la interfaz IConvertible está diseñada para admitir la conversión entre los tipos base de .NET Framework. Sin embargo, la interfaz también puede implementarse por un tipo personalizado con el fin de admitir la conversión de ese tipo a otros tipos personalizados. Para obtener más información, vea la sección Conversiones personalizadas con el método ChangeType más adelante en este tema.

Volver al principio

Aunque se puede llamar a la implementación de la interfaz IConvertible de cada tipo base para realizar una conversión de tipo, llamar a los métodos de la clase System.Convert es la manera recomendada de convertir de un tipo base en otro de una manera independiente del lenguaje. Además, se puede usar el método Convert.ChangeType(Object, Type, IFormatProvider) para convertir de un tipo personalizado concreto a otro tipo.

98bbex99.collapse_all(es-es,VS.110).gifConversiones entre los tipos base

La clase Convert proporciona una manera independiente del lenguaje de realizar conversiones entre los tipos base y está disponible para todos los lenguajes cuyo destino es Common Language Runtime. Ofrece un conjunto completo de métodos tanto para conversiones de ampliación como de restricción e inicia una excepción InvalidCastException para las conversiones que no se admiten (como la conversión de un valor DateTime a un valor entero). Las conversiones de restricción se realizan en un contexto comprobado y se inicia una excepción OverflowException si se produce un error en la conversión.

Nota importante Importante

Puesto que la clase Convert incluye métodos para efectuar la conversión directa e inversa de cada tipo base, elimina la necesidad de llamar a la implementación de interfaz explícita IConvertible de cada tipo base.

En el ejemplo siguiente se muestra el uso de la clase System.Convert para realizar varias conversiones de restricción y ampliación entre los tipos base de .NET Framework.


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


En algunos casos, en especial al efectuar conversiones directas e inversas de valores de punto flotante, una conversión puede conllevar una pérdida de precisión, aunque no se inicie una excepción OverflowException. En el ejemplo siguiente se muestra esta pérdida de precisión. En el primer caso, un valor Decimal tiene menos precisión (menos dígitos significativos) cuando se convierte en el tipo Double. En el segundo caso, un valor Double se redondea de 42,72 a 43 para completar la conversión.


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.


Para obtener una tabla en la que se muestra una lista de conversiones de restricción y ampliación admitidas por la clase Convert, vea Tablas de conversiones de tipos.

98bbex99.collapse_all(es-es,VS.110).gifConversiones personalizadas con el método ChangeType

Además de admitir las conversiones en cada uno de los tipos base, la clase Convert se puede usar para convertir un tipo personalizado en uno o varios tipos predefinidos. El método Convert.ChangeType(Object, Type, IFormatProvider), que a su vez contiene una llamada al método IConvertible.ToType del parámetro value, realiza esta conversión. Esto significa que el objeto representado por el parámetro value debe proporcionar una implementación de la interfaz IConvertible.

Nota Nota

Dado que los métodos Convert.ChangeType(Object, Type) y Convert.ChangeType(Object, Type, IFormatProvider) utilizan un objeto Type para especificar el tipo de destino al que se convierte value, se pueden utilizar para realizar una conversión dinámica a un objeto cuyo tipo se desconoce en tiempo de compilación. Sin embargo, observe que la implementación de IConvertible de value aún debe admitir esta conversión.

En el ejemplo siguiente se muestra una posible implementación de la interfaz IConvertible que permite convertir un objeto TemperatureCelsius en un objeto TemperatureFahrenheit y viceversa. En el ejemplo se define una clase base, Temperature, que implementa la interfaz IConvertible e invalida el método Object.ToString. Cada una de las clases derivadas TemperatureCelsius y TemperatureFahrenheit invalida los métodos ToType y ToString de la clase 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 methood.
      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));
      }                                 
   }
}   


En el ejemplo siguiente se muestran varias llamadas a estas implementaciones de IConvertible para convertir los objetos TemperatureCelsius en objetos TemperatureFahrenheit y viceversa.


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.


Volver al principio

.NET Framework también permite definir un convertidor de tipos para un tipo personalizado extendiendo la clase System.ComponentModel.TypeConverter y asociando el convertidor de tipos al tipo mediante un atributo System.ComponentModel.TypeConverterAttribute. En la tabla siguiente se resaltan las diferencias entre este enfoque y la implementación de la interfaz IConvertible para un tipo personalizado.

Nota Nota

Se puede proporcionar compatibilidad en tiempo de diseño para un tipo personalizado sólo si se ha definido un convertidor de tipos para éste.

Conversión mediante TypeConverter

Conversión mediante IConvertible

Se implementa para un tipo personalizado derivando una clase independiente de TypeConverter. Esta clase derivada se asocia al tipo personalizado aplicando un atributo TypeConverterAttribute.

Se implementa mediante un tipo personalizado para realizar la conversión. Un usuario del tipo invoca un método de conversión de IConvertible para el tipo.

Se puede utilizar en tiempo de diseño y en tiempo de ejecución.

Sólo se puede utilizar en tiempo de ejecución.

Usa la reflexión; por tanto, es más lenta que la conversión mediante IConvertible.

No utiliza la reflexión.

Permite realizar conversiones bidireccionales; es decir, convertir el tipo personalizado en otros tipos de datos y convertir otros tipos de datos en el tipo personalizado. Por ejemplo, un objeto TypeConverter definido para MyType permite conversiones de MyType a String y de String a MyType.

Permite convertir un tipo personalizado en otros tipos de datos, pero no otros tipos de datos en el tipo personalizado.

Para obtener más información sobre cómo usar convertidores de tipos para realizar conversiones, vea System.ComponentModel.TypeConverter.

Volver al principio

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft