Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Každá hodnota má přidružený typ, který definuje atributy, jako je množství místa přidělené hodnotě, rozsah možných hodnot, které může mít, a členy, které zpřístupňuje. Mnoho hodnot lze vyjádřit jako více než jeden typ. Například hodnotu 4 lze vyjádřit jako celé číslo nebo reálné číslo. Převod typu vytvoří hodnotu v novém typu, která je ekvivalentní hodnotě starého typu, ale nemusí nutně zachovat identitu (nebo přesnou hodnotu) původního objektu.
.NET automaticky podporuje následující převody:
Převod z odvozené třídy na základní třídu To například znamená, že instanci jakékoli třídy nebo struktury lze převést na instanci Object. Tento převod nevyžaduje operátor přetypování ani převodu.
Převod ze základní třídy zpět na původní odvozenou třídu. V jazyce C# tento převod vyžaduje operátor přetypování. V jazyce Visual Basic je vyžadován operátor
CType, pokud jeOption Strictzapnuto.Převod z typu, který implementuje rozhraní na objekt rozhraní, který představuje toto rozhraní. Tento převod nevyžaduje operátor přetypování ani převodu.
Převod z objektu rozhraní zpět na původní typ, který implementuje toto rozhraní. V jazyce C# tento převod vyžaduje operátor přetypování. V jazyce Visual Basic je vyžadován operátor
CType, pokud jeOption Strictzapnuto.
Kromě těchto automatických převodů poskytuje .NET několik funkcí, které podporují převod vlastních typů. Patří mezi ně následující:
Operátor
Implicit, který definuje dostupné rozšiřující převody mezi typy. Další informace najdete v oddílu Implicitní převod pomocí implicitního operátoru.Operátor
Explicit, který definuje dostupné zužující převody mezi typy. Další informace naleznete v části Explicitní konverze s operátorem Explicit.Rozhraní IConvertible, které definuje převody na každý ze základních datových typů .NET. Pokud další informace potřebujete, podívejte se na část Rozhraní IConvertible.
Třída Convert, která poskytuje sadu metod, které implementují metody v rozhraní IConvertible. Další informace najdete v oddílu Převést třídu.
Třída TypeConverter, což je základní třída, která se dá rozšířit tak, aby podporovala převod zadaného typu na jakýkoli jiný typ. Další informace najdete v části Třída TypeConverter.
Implicitní převod pomocí implicitního operátoru
Rozšiřující převody zahrnují vytvoření nové hodnoty z hodnoty existujícího typu, který má omezenější rozsah nebo omezenější seznam členů než cílový typ. Rozšiřující převody nemohou vést ke ztrátě dat (i když mohou vést ke ztrátě přesnosti). Vzhledem k tomu, že data nelze ztratit, kompilátory mohou převod zpracovat implicitně nebo transparentně, aniž by bylo nutné použít explicitní metodu převodu nebo operátor přetypování.
Poznámka:
I když kód, který provádí implicitní převod, může volat metodu převodu nebo použít operátor přetypování, jejich použití není vyžadováno kompilátory, které podporují implicitní převody.
Například typ Decimal podporuje implicitní převody z Byte, Char, Int16, Int32, Int64, SByte, UInt16, UInt32a UInt64 hodnot. Následující příklad ukazuje některé z těchto implicitních převodů při přiřazování hodnot k proměnné 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}.",
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.
Pokud určitý kompilátor jazyka podporuje vlastní operátory, můžete také definovat implicitní převody ve vlastních typech. Následující příklad poskytuje částečnou implementaci podepsaného bajtového datového typu pojmenovaného ByteWithSign, která používá reprezentaci znaménka a velikosti. Podporuje implicitní převod hodnot Byte a SByte na ByteWithSign hodnoty.
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
Klientský kód pak může deklarovat ByteWithSign proměnnou a přiřadit ji Byte a SByte hodnoty, aniž by prováděl explicitní převody nebo používal operátory přetypování, jak ukazuje následující příklad.
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
Explicitní převod pomocí explicitního operátoru
Zužující převody zahrnují vytvoření nové hodnoty z hodnoty existujícího typu, která má větší rozsah nebo větší seznam členů než cílový typ. Vzhledem k tomu, že zužující převod může vést ke ztrátě dat, kompilátory často vyžadují explicitní převod prostřednictvím volání přetypovací metody nebo operátoru přetypování. To znamená, že převod musí být zpracován explicitně v kódu vývojáře.
Poznámka:
Hlavním účelem vyžadování metody převodu nebo operátoru přetypování pro zužující převody je, aby vývojář věděl o možnosti ztráty dat nebo OverflowException, aby bylo možné je zpracovat v kódu. Některé kompilátory však mohou tento požadavek uvolnit. Pokud je například v jazyce Visual Basic vypnuta Option Strict (výchozí nastavení), kompilátor jazyka Visual Basic se pokusí implicitně provádět zužující převody.
Například UInt32, Int64a UInt64 datové typy mají rozsahy, které překračují datový typ Int32, jak ukazuje následující tabulka.
| Typ | Porovnání s rozsahem Int32 |
|---|---|
| Int64 | Int64.MaxValue je větší než Int32.MaxValuea Int64.MinValue je menší než (má větší záporný rozsah než) Int32.MinValue. |
| UInt32 | UInt32.MaxValue je větší než Int32.MaxValue. |
| UInt64 | UInt64.MaxValue je větší než Int32.MaxValue. |
Pro zpracování takových zužujících převodů umožňuje .NET typům definovat operátor Explicit. Jednotlivé jazykové kompilátory mohou tento operátor implementovat pomocí vlastní syntaxe, nebo lze zavolat člena třídy Convert k provedení převodu. (Další informace o třídě Convert naleznete v části Třída Convert dále v tomto tématu.) Následující příklad ilustruje použití jazykových prvků pro zpracování explicitního převodu těchto potenciálně mimo rozsah celočíselných hodnot na hodnoty 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.
Explicitní převody mohou vést k různým výsledkům v různých jazycích a tyto výsledky se mohou lišit od hodnoty vrácené odpovídající metodou Convert. Pokud je například hodnota Double 12,63251 převedena na Int32, metoda jazyka Visual Basic CInt i metoda .NET Convert.ToInt32(Double) zaokrouhlují Double tak, aby vrátily hodnotu 13, ale operátor (int) jazyka C# zkrátí Double, aby vrátil hodnotu 12. Podobně operátor (int) jazyka C# nepodporuje převod typu Boolean-to-integer, ale metoda CInt jazyka Visual Basic převede hodnotu true na -1. Na druhou stranu metoda Convert.ToInt32(Boolean) převede hodnotu true na 1.
Většina kompilátorů umožňuje provádět explicitní převody kontrolovaným nebo nezaškrtnutým způsobem. Při provedení kontrolovaného převodu se OverflowException vyvolá, když hodnota typu, který se má převést, je mimo rozsah cílového typu. Pokud je proveden převod bez kontroly za stejných podmínek, převod nemusí vyvolat výjimku, ale přesné chování se stane nedefinovaným a může dojít k nesprávné hodnotě.
Poznámka:
V jazyce C# lze kontrolované převody provádět pomocí klíčového slova checked v kombinaci s operátorem přetypování nebo specifikací možnosti kompilátoru /checked+. Naopak nezaškrtnuté převody lze provádět pomocí klíčového slova unchecked společně s operátorem přetypování nebo zadáním možnosti kompilátoru /checked-. Ve výchozím nastavení jsou explicitní převody nezaškrtnuté. V jazyce Visual Basic lze kontrolované převody provádět zrušením zaškrtnutí políčka Odebrat přetečení celého čísla v dialogovém okně Upřesněná nastavení kompilátoru projektu, nebo zadáním možnosti /removeintchecks- kompilátoru. Naopak nezaškrtnuté převody lze provést výběrem zaškrtávacího políčka Odebrat kontroly přetečení celých čísel v dialogovém okně Upřesnit nastavení kompilátoru nebo nastavením možnosti kompilátoru /removeintchecks+. Ve výchozím nastavení jsou explicitní převody zaškrtnuté.
Následující příklad jazyka C# používá klíčová slova checked a unchecked k ilustraci rozdílu v chování, když je hodnota mimo rozsah Byte převedena na Byte. Kontrolovaný převod vyvolá výjimku, ale nezaškrtnutá konverze přiřadí Byte.MaxValue proměnné Byte.
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.
Pokud konkrétní kompilátor jazyka podporuje vlastní přetížené operátory, můžete také definovat explicitní převody ve vlastních typech. Následující příklad poskytuje částečnou implementaci podepsaného bajtového datového typu pojmenovaného ByteWithSign, která používá reprezentaci znaménka a velikosti. Podporuje explicitní převod hodnot Int32 a UInt32 na hodnoty 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
Klientský kód pak může deklarovat ByteWithSign proměnnou a přiřadit ji Int32 a UInt32 hodnoty, pokud přiřazení zahrnují operátor přetypování nebo metodu převodu, jak ukazuje následující příklad.
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.
Rozhraní IConvertible
Pro podporu převodu libovolného typu na základní typ modulu CLR (Common Language Runtime) poskytuje .NET rozhraní IConvertible. Je požadováno, aby implementační typ poskytl následující:
Metoda, která vrací TypeCode implementního typu.
Metody převodu typu implementace na každý základní typ modulu CLR (Boolean, Byte, DateTime, Decimal, Doubleatd.
Zobecněná metoda převodu pro převod instance implementovaného typu na jiný zadaný typ. Převody, které nejsou podporovány, by měly vyvolat InvalidCastException.
Každý základní typ modulu CLR (tj. základní typ modulu Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32a UInt64), a také DBNull a Enum, implementují rozhraní IConvertible. Jedná se však o explicitní implementace rozhraní; metodu převodu lze volat pouze prostřednictvím proměnné rozhraní IConvertible, jak ukazuje následující příklad. Tento příklad převede hodnotu Int32 na ekvivalentní hodnotu 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)
Požadavek na volání metody převodu na rozhraní spíše než na implementační typ činí explicitní implementace rozhraní relativně nákladnými. Místo toho doporučujeme volat příslušného člena třídy Convert pro převod mezi základními typy modulu CLR (Common Language Runtime). Další informace najdete v následující části Třída Convert.
Poznámka:
Kromě rozhraní IConvertible a třídy Convert poskytované rozhraním .NET mohou jednotlivé jazyky také poskytovat způsoby provádění převodů. C# například používá operátory přetypování; Jazyk Visual Basic používá funkce převodu implementované kompilátorem, jako jsou CType, CInta DirectCast.
Ve většině případů je rozhraní IConvertible navržené tak, aby podporovalo převod mezi základními typy v .NET. Rozhraní však může být také implementováno vlastním typem pro podporu převodu tohoto typu na jiné vlastní typy. Další informace najdete v části vlastní převody pomocí metody ChangeType dále v tomto tématu.
Třída Convert
Přestože je možné volat implementaci rozhraní IConvertible jednotlivých základních typů, volání metod System.Convert třídy je doporučený jazykově neutrální způsob, jak převést z jednoho základního typu na jiný. Kromě toho lze Convert.ChangeType(Object, Type, IFormatProvider) metodu použít k převodu ze zadaného vlastního typu na jiný typ.
Převody mezi základními typy
Třída Convert poskytuje jazykově neutrální způsob provádění převodů mezi základními typy a je k dispozici pro všechny jazyky, které cílí na modul CLR (Common Language Runtime). Poskytuje kompletní sadu metod pro rozšiřující i zúžení převodů a vyvolá InvalidCastException pro převody, které nejsou podporovány (například převod hodnoty DateTime na celočíselnou hodnotu). Úzké konverze se provádějí v kontrolovaném prostředí a OverflowException je vyvolán, pokud převod selže.
Důležité
Vzhledem k tomu, že třída Convert obsahuje metody pro převod na a z každého základního typu, eliminuje nutnost volat explicitní implementaci rozhraní každého základního typu IConvertible.
Následující příklad ukazuje použití System.Convert třídy k provedení několika rozšiřujících a zúžených převodů mezi základními typy .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.
V některých případech, zejména při převodu na a z hodnot s plovoucí desetinnou čárkou, může převod zahrnovat ztrátu přesnosti, i když nevyvolá OverflowException. Následující příklad ukazuje tuto ztrátu přesnosti. V prvním případě má hodnota Decimal menší přesnost (méně významných číslic) při převodu na Double. V druhém případě se hodnota Double zaokrouhlí od 42,72 do 43, aby bylo možné převod dokončit.
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.
Tabulku, která uvádí rozšiřující i zužující převody podporované třídou Convert, naleznete v části Tabulky převodu typů.
Vlastní převody pomocí metody ChangeType
Kromě podpůrných převodů na každý základní typ lze Convert třídu použít k převodu vlastního typu na jeden nebo více předdefinovaných typů. Tento převod provádí metoda Convert.ChangeType(Object, Type, IFormatProvider), která následně zabalí volání na metodu IConvertible.ToType parametru value. To znamená, že objekt reprezentovaný parametrem value musí poskytovat implementaci IConvertible rozhraní.
Poznámka:
Protože Convert.ChangeType(Object, Type) a Convert.ChangeType(Object, Type, IFormatProvider) metody používají objekt Type k určení cílového typu, na který value je převeden, lze je použít k provedení dynamického převodu na objekt, jehož typ není znám v době kompilace. Mějte však na paměti, že IConvertible implementace value musí tento převod nadále podporovat.
Následující příklad ukazuje možnou implementaci IConvertible rozhraní, které umožňuje TemperatureCelsius objekt převést na TemperatureFahrenheit objekt a naopak. Příklad definuje základní třídu Temperature, která implementuje IConvertible rozhraní a přepíše Object.ToString metodu. Odvozené třídy TemperatureCelsius a TemperatureFahrenheit každá přepíše metody ToType a ToString základní třídy.
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
Následující příklad ukazuje několik volání těchto IConvertible implementací pro převod TemperatureCelsius objektů na TemperatureFahrenheit objekty a naopak.
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.
Třída TypeConverter
Rozhraní .NET také umožňuje definovat převaděč typů pro vlastní typ rozšířením třídy System.ComponentModel.TypeConverter a přidružením převaděče typů k typu prostřednictvím atributu System.ComponentModel.TypeConverterAttribute. Následující tabulka uvádí rozdíly mezi tímto přístupem a implementací rozhraní IConvertible pro vlastní typ.
Poznámka:
Podporu návrhu lze poskytnout pro vlastní typ pouze v případě, že má pro něj definovaný převaděč typů.
| Převod pomocí TypeConverteru | Převod pomocí IConvertible |
|---|---|
| Je implementována pro vlastní typ odvozením samostatné třídy od TypeConverter. Tato odvozená třída je přidružena k vlastnímu typu použitím atributu TypeConverterAttribute. | Implementuje se vlastním typem pro provedení převodu. Uživatel typu vyvolá na typu metodu IConvertible převodu. |
| Lze použít v době návrhu i za běhu. | Lze použít pouze za běhu. |
| Použití reflexe znamená, že je pomalejší než převod povolený pomocí IConvertible. | Nepoužívá reflexi. |
Umožňuje obousměrné převody typů z vlastního typu na jiné datové typy a z jiných datových typů na vlastní typ. Například TypeConverter definovaný pro MyType umožňuje převody z MyType na Stringa z String na MyType. |
Umožňuje převod z vlastního typu na jiné datové typy, ale ne z jiných datových typů na vlastní typ. |
Další informace o použití převaděčů typů k provádění převodů naleznete v tématu System.ComponentModel.TypeConverter.