.NET içinde tür dönüştürme
Her değerin, değere ayrılan alan miktarı, sahip olabileceği olası değerler aralığı ve kullanılabilir hale getirdiği üyeler gibi öznitelikleri tanımlayan ilişkili bir türü vardır. Birçok değer, tek bir türden fazlası olarak ifade edilebilir. Örneğin, 4 değeri bir tamsayı olarak veya bir kayan nokta değeri olarak ifade edilebilir. Tür dönüştürme, eski bir türün değerine eşit olan, yeni türde bir değer oluşturur, fakat özgün nesnenin kimliğini (veya tam değerini) koruması gerekmez.
.NET aşağıdaki dönüştürmeleri otomatik olarak destekler:
Türetilmiş bir sınıftan temel sınıfa dönüştürme. Bu, örneğin herhangi bir sınıfın veya yapının örneğinin bir Object örneğe dönüştürülebileceği anlamına gelir. Bu dönüştürme için bir atama veya dönüştürme işleci gerekmez.
Temel sınıftan özgün türetilmiş sınıfa dönüştürme. C# dilinde bu dönüştürme için bir atama işleci gerekir. Visual Basic'te, açıksa
Option Strict
işlecini gerektirirCType
.Arabirimi uygulayan bir türden bu arabirimi temsil eden bir arabirim nesnesine dönüştürme. Bu dönüştürme için bir atama veya dönüştürme işleci gerekmez.
Bir arabirim nesnesinden bu arabirimi uygulayan özgün türe dönüştürme. C# dilinde bu dönüştürme için bir atama işleci gerekir. Visual Basic'te, açıksa
Option Strict
işlecini gerektirirCType
.
.NET, bu otomatik dönüştürmelere ek olarak özel tür dönüştürmeyi destekleyen çeşitli özellikler sağlar. Bunlar aşağıdakileri içerir:
Implicit
türler arasındaki kullanılabilir genişletme dönüştürmelerini tanımlayan işleç. Daha fazla bilgi için Örtük İşleç ile Örtük Dönüştürme bölümüne bakın.Explicit
türler arasındaki kullanılabilir daraltma dönüştürmelerini tanımlayan işleç. Daha fazla bilgi için Açık İşleç ile Açık Dönüştürme bölümüne bakın.IConvertible Temel .NET veri türlerinin her birine dönüştürmeleri tanımlayan arabirim. Daha fazla bilgi için IConvertible Arabirimi bölümüne bakın.
Convert sınıfı, arabirimdeki IConvertible yöntemleri uygulayan bir dizi yöntem sağlar. Daha fazla bilgi için Sınıf Dönüştürme bölümüne bakın.
Sınıfı TypeConverter , belirtilen bir türün başka bir türe dönüştürülmesi için genişletilebilen bir temel sınıftır. Daha fazla bilgi için Bkz . TypeConverter Sınıfı bölümü.
Örtük işleçle örtük dönüştürme
Genişletme dönüştürmeleri, varolan bir türün değerinden, hedef türe göre daha kısıtlayıcı bir aralığı veya daha kısıtlayıcı bir üye listesi olan yeni bir değer oluşturmayı gerektirir. Genişletme dönüştürmeleri, (kesinlik kaybıyla sonuçlanabilir olsalar da) veri kaybıyla sonuçlanmaz. Veriler kaybedilemeyeceğinden, derleyiciler, açık bir dönüştürme yöntemi veya bir yayın işleci kullanılmadan, dönüştürmeyi örtülü olarak veya saydam olarak işleyebilir.
Not
Örtülü bir dönüştürme uygulayan kod bir dönüştürme yöntemi çağırabilir veya bir yayımlama işleci kullanabilir olsa da, örtülü dönüştürmeleri destekleyen derleyiciler tarafından kullanılmaları gerekmez.
Örneğin, Decimal türü , , Char, , Int16, Int32, Int64, , SByte, UInt16UInt32, ve UInt64 değerlerinden Byteörtük dönüştürmeleri destekler. Aşağıdaki örnekte, bir Decimal değişkene değer atamada bu örtük dönüştürmelerden bazıları gösterilmektedir.
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.
Belirli bir dil derleyicisi özel işleçleri desteklerse, kendi özel türlerinizde de örtülü dönüştürmeler tanımlayabilirsiniz. Aşağıdaki örnek, sign-and-magnitude gösterimi kullanan adlı ByteWithSign
imzalı bayt veri türünün kısmi bir uygulamasını sağlar. ve SByte değerlerinin Byte değerlere örtük olarak dönüştürülmesi ByteWithSign
desteklemektedir.
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
İstemci kodu daha sonra bir değişken bildirebilir ve aşağıdaki örnekte gösterildiği gibi herhangi bir ByteWithSign
açık dönüştürme gerçekleştirmeden veya herhangi bir atama işleci kullanmadan değişkeni ve SByte değerleri atayabilirByte.
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
Açık işleçle açık dönüştürme
Dönüştürmeleri daraltma, hedef türden daha geniş bir aralığa veya daha büyük bir üye listesine sahip olan varolan bir türün değerinden yeni bir değer oluşturulmasını gerektirir. Bir daraltma dönüşümü veri kaybıyla sonuçlanabildiğinden, derleyiciler genellikle dönüştürmenin bir dönüştürme yöntemine veya bir yayımlama işlecine yapılan bir çağrı yoluyla açık hale getirilmesini gerektirir. Yani, dönüştürmenin, geliştirici kodunda açıkça işlenmesi gerekir.
Not
Dönüştürmeleri daraltmak için bir dönüştürme yöntemi veya atama işleci gerektirmenin temel amacı, geliştiricinin veri kaybı olasılığını veya OverflowException kodda işlenebilmesini sağlamaktır. Ancak, bazı derleyiciler bu gereksinimi ılımlı hale getirebilir. Örneğin, Visual Basic'te kapalıysa Option Strict
(varsayılan ayarı), Visual Basic derleyicisi örtük olarak daraltma dönüştürmeleri gerçekleştirmeye çalışır.
Örneğin, , ve UInt64 veri türlerinin UInt32Int64aralıkları aşağıdaki tabloda gösterildiği gibi veri türünü aşıyorInt32.
Tür | Int32 aralığıyla karşılaştırma |
---|---|
Int64 | Int64.MaxValue değerinden Int32.MaxValuebüyüktür ve Int64.MinValue değerinden küçüktür (negatif aralığı büyüktür) Int32.MinValue. |
UInt32 | UInt32.MaxValue değerinden Int32.MaxValuebüyüktür. |
UInt64 | UInt64.MaxValue değerinden Int32.MaxValuebüyüktür. |
.NET, bu tür daraltma dönüştürmelerini işlemek için türlerin bir Explicit
işleç tanımlamasına izin verir. Tek tek dil derleyicileri kendi söz dizimlerini kullanarak bu işleci uygulayabilir veya dönüştürmeyi gerçekleştirmek için sınıfın Convert bir üyesi çağrılabilir. (Sınıf hakkında Convert daha fazla bilgi için bu konunun devamında yer alan Sınıfı Dönüştür bölümüne bakın.) Aşağıdaki örnekte, bu aralık dışı olabilecek tamsayı değerlerinin Int32 değerlere açıkça dönüştürülmesi için dil özelliklerinin kullanımı gösterilmektedir.
long number1 = int.MaxValue + 20L;
uint number2 = int.MaxValue - 1000;
ulong number3 = int.MaxValue;
int intNumber;
try
{
intNumber = checked((int)number1);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number1.GetType().Name, intNumber);
}
catch (OverflowException)
{
if (number1 > int.MaxValue)
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, int.MaxValue);
else
Console.WriteLine("Conversion failed: {0} is less than {1}.",
number1, int.MinValue);
}
try
{
intNumber = checked((int)number2);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number2.GetType().Name, intNumber);
}
catch (OverflowException)
{
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number2, int.MaxValue);
}
try
{
intNumber = checked((int)number3);
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number3.GetType().Name, intNumber);
}
catch (OverflowException)
{
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, int.MaxValue);
}
// The example displays the following output:
// Conversion failed: 2147483667 exceeds 2147483647.
// After assigning a UInt32 value, the Integer value is 2147482647.
// After assigning a UInt64 value, the Integer value is 2147483647.
Dim number1 As Long = Integer.MaxValue + 20L
Dim number2 As UInteger = Integer.MaxValue - 1000
Dim number3 As ULong = Integer.MaxValue
Dim intNumber As Integer
Try
intNumber = CInt(number1)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number1.GetType().Name, intNumber)
Catch e As OverflowException
If number1 > Integer.MaxValue Then
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, Integer.MaxValue)
Else
Console.WriteLine("Conversion failed: {0} is less than {1}.\n",
number1, Integer.MinValue)
End If
End Try
Try
intNumber = CInt(number2)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number2.GetType().Name, intNumber)
Catch e As OverflowException
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number2, Integer.MaxValue)
End Try
Try
intNumber = CInt(number3)
Console.WriteLine("After assigning a {0} value, the Integer value is {1}.",
number3.GetType().Name, intNumber)
Catch e As OverflowException
Console.WriteLine("Conversion failed: {0} exceeds {1}.",
number1, Integer.MaxValue)
End Try
' The example displays the following output:
' Conversion failed: 2147483667 exceeds 2147483647.
' After assigning a UInt32 value, the Integer value is 2147482647.
' After assigning a UInt64 value, the Integer value is 2147483647.
Açık dönüştürmeler farklı dillerde farklı sonuçlar üretebilir ve bu sonuçlar ilgili Convert yöntem tarafından döndürülen değerden farklı olabilir. Örneğin, 12.63251 değeri bir Int32değerine dönüştürülürseDouble, hem Visual Basic CInt
yöntemi hem de .NET Convert.ToInt32(Double) yöntemi 13 değerini döndürmek için öğesini yuvarlarDouble, ancak C# (int)
işleci 12 değerini döndürmek için değerini Double keser. Benzer şekilde, C# (int)
işleci Boole'den tamsayıya dönüştürmeyi desteklemez, ancak Visual Basic CInt
yöntemi değerini -1'e dönüştürür true
. Öte yandan, Convert.ToInt32(Boolean) yöntemi değerini 1'e true
dönüştürür.
Derleyicilerin çoğu, açık dönüştürmelerin denetlenen veya denetlenmeyen bir şekilde yapılmasına olanak tanır. İşaretli dönüştürme gerçekleştirildiğinde, dönüştürülecek türün değeri hedef türün aralığının dışında olduğunda bir OverflowException oluşturulur. Aynı koşullarda denetlenmeyen bir dönüştürme yapıldığında, dönüştürme bir özel durum oluşturmayabilir, fakat davranış tam olarak tanımsız hale gelir ve sonuç olarak hatalı bir değer oluşabilir.
Not
C# dilinde, anahtar sözcük bir atama işleciyle birlikte kullanılarak checked
veya derleyici seçeneği belirtilerek /checked+
denetlenen dönüştürmeler gerçekleştirilebilir. Buna karşılık, anahtar sözcük atama işleciyle birlikte kullanılarak unchecked
veya derleyici seçeneği belirtilerek denetlenmeyen /checked-
dönüştürmeler gerçekleştirilebilir. Varsayılan olarak, açık dönüştürmeler denetlenmez. Visual Basic'te, projenin Gelişmiş Derleyici Ayarlar iletişim kutusundaki Tamsayı taşma denetimlerini kaldır onay kutusu temizlenerek veya derleyici seçeneği belirtilerek /removeintchecks-
işaretli dönüştürmeler gerçekleştirilebilir. Buna karşılık, projenin Gelişmiş Derleyici Ayarlar iletişim kutusunda Tamsayı taşma denetimlerini kaldır onay kutusu seçilerek veya derleyici seçeneği belirtilerek /removeintchecks+
işaretlenmemiş dönüştürmeler gerçekleştirilebilir. Varsayılan olarak, açık dönüştürmeler denetlenir.
Aşağıdaki C# örneği, aralığının checked
dışındaki bir değer değerine dönüştürüldüğünde davranış farkını Byte göstermek için ve unchecked
anahtar sözcüklerini Bytekullanır. İşaretlenen dönüştürme bir özel durum oluşturur, ancak işaretsiz dönüştürme değişkenine Byte atarByte.MaxValue.
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.
Belirli bir dil derleyicisi özel aşırı yüklü işleçleri desteklerse, kendi özel türlerinizde de açık dönüştürmeler tanımlayabilirsiniz. Aşağıdaki örnek, sign-and-magnitude gösterimi kullanan adlı ByteWithSign
imzalı bayt veri türünün kısmi bir uygulamasını sağlar. ve UInt32 değerlerinin Int32 değerlere açıkça dönüştürülmesi ByteWithSign
desteklemektedir.
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
İstemci kodu daha sonra aşağıdaki örnekte gösterildiği gibi atamalar bir atama işleci veya dönüştürme yöntemi içerdiğinde bir ByteWithSign
değişken bildirebilir ve bu Int32 değişkeni ve UInt32 değerleri atayabilir.
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.
IConvertible arabirimi
.NET, herhangi bir türün ortak dil çalışma zamanı temel türüne dönüştürülmesi için arabirimini IConvertible sağlar. Uygulama türünün aşağıdakileri sağlaması gerekir:
Uygulayan türün değerini döndüren TypeCode bir yöntem.
Uygulama türünü her ortak dil çalışma zamanı temel türüne (Boolean, Byte, DateTime, Decimal, , Doublevb.) dönüştürme yöntemleri.
Uygulama türünün bir örneğini başka bir belirtilen türe dönüştürmek için genelleştirilmiş bir dönüştürme yöntemi. Desteklenmeyen dönüştürmeler bir InvalidCastExceptionoluşturmalıdır.
Her ortak dil çalışma zamanı temel türü (yani Boolean, Byte, Char, DateTime, Decimal, , Double, SByteInt32Int64SingleInt16, String, , UInt16, UInt32ve UInt64) DBNullEnum ve türleri arabirimini IConvertible uygulayın. Ancak bunlar açık arabirim uygulamalarıdır; dönüştürme yöntemi, aşağıdaki örnekte gösterildiği gibi yalnızca bir IConvertible arabirim değişkeni aracılığıyla çağrılabilir. Bu örnek, bir Int32 değeri eşdeğer Char değerine dönüştürür.
int codePoint = 1067;
IConvertible iConv = codePoint;
char ch = iConv.ToChar(null);
Console.WriteLine("Converted {0} to {1}.", codePoint, ch);
Dim codePoint As Integer = 1067
Dim iConv As IConvertible = codePoint
Dim ch As Char = iConv.ToChar(Nothing)
Console.WriteLine("Converted {0} to {1}.", codePoint, ch)
Dönüştürme yöntemini, uygulama türünde değil, kendi arabiriminde çağırma gereksinimi, açık arabirim uygulamalarını görece pahalılaştırır. Bunun yerine, ortak dil çalışma zamanı temel türleri arasında dönüştürmek için sınıfının uygun üyesini Convert çağırmanızı öneririz. Daha fazla bilgi için sonraki Sınıf Dönüştürme bölümüne bakın.
Not
.NET tarafından sağlanan arabirime ve sınıfa IConvertibleConvert ek olarak, tek tek diller de dönüştürme gerçekleştirmenin yollarını sağlayabilir. Örneğin, C# atama işleçlerini kullanır; Visual Basic, , CInt
ve DirectCast
gibi CType
derleyici tarafından uygulanan dönüştürme işlevlerini kullanır.
Çoğunlukla arabirim, IConvertible .NET'teki temel türler arasında dönüştürmeyi destekleyecek şekilde tasarlanmıştır. Ancak, arabirim, o türün diğer özel türlere dönüştürülmesini desteklemek için özel bir tür tarafından da uygulanabilir. Daha fazla bilgi için bu konunun devamında yer alan ChangeType Yöntemi ile Özel Dönüştürmeler bölümüne bakın.
Convert sınıfı
Her temel türün IConvertible arabirim uygulaması bir tür dönüştürmesi gerçekleştirmek için çağrılsa da, sınıfının yöntemlerini System.Convert çağırmak, bir temel türden diğerine dönüştürmek için önerilen dil nötr yoludur. Ayrıca yöntemi, Convert.ChangeType(Object, Type, IFormatProvider) belirtilen özel türden başka bir türe dönüştürmek için kullanılabilir.
Temel türler arasındaki dönüştürmeler
sınıfı, Convert temel türler arasında dönüştürmeler gerçekleştirmek için dilden bağımsız bir yol sağlar ve ortak dil çalışma zamanını hedefleyen tüm diller için kullanılabilir. Hem genişletme hem de daraltma dönüştürmeleri için eksiksiz bir yöntem kümesi sağlar ve InvalidCastException desteklenmeyen dönüştürmeler için (bir değerin tamsayı değerine dönüştürülmesi gibi) bir DateTime oluşturur. Daraltma dönüştürmeleri denetlenen bir bağlamda gerçekleştirilir ve dönüştürme başarısız olursa oluşturulur OverflowException .
Önemli
Convert sınıfı her temel türe ve her türe dönüştürme yöntemleri içerdiğinden, her temel türün IConvertible açık arabirim uygulamasını çağırma gereksinimini ortadan kaldırır.
Aşağıdaki örnek, .NET temel türleri arasında çeşitli genişletme ve daraltma dönüştürmeleri gerçekleştirmek için sınıfının kullanımını System.Convert göstermektedir.
// Convert an Int32 value to a Decimal (a widening conversion).
int integralValue = 12534;
decimal decimalValue = Convert.ToDecimal(integralValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:N2}.",
integralValue.GetType().Name,
integralValue,
decimalValue.GetType().Name,
decimalValue);
// Convert a Byte value to an Int32 value (a widening conversion).
byte byteValue = Byte.MaxValue;
int integralValue2 = Convert.ToInt32(byteValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
byteValue.GetType().Name,
byteValue,
integralValue2.GetType().Name,
integralValue2);
// Convert a Double value to an Int32 value (a narrowing conversion).
double doubleValue = 16.32513e12;
try
{
long longValue = Convert.ToInt64(doubleValue);
Console.WriteLine("Converted the {0} value {1:E} to " +
"the {2} value {3:N0}.",
doubleValue.GetType().Name,
doubleValue,
longValue.GetType().Name,
longValue);
}
catch (OverflowException)
{
Console.WriteLine("Unable to convert the {0:E} value {1}.",
doubleValue.GetType().Name, doubleValue);
}
// Convert a signed byte to a byte (a narrowing conversion).
sbyte sbyteValue = -16;
try
{
byte byteValue2 = Convert.ToByte(sbyteValue);
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
sbyteValue.GetType().Name,
sbyteValue,
byteValue2.GetType().Name,
byteValue2);
}
catch (OverflowException)
{
Console.WriteLine("Unable to convert the {0} value {1}.",
sbyteValue.GetType().Name, sbyteValue);
}
// The example displays the following output:
// Converted the Int32 value 12534 to the Decimal value 12,534.00.
// Converted the Byte value 255 to the Int32 value 255.
// Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
// Unable to convert the SByte value -16.
' Convert an Int32 value to a Decimal (a widening conversion).
Dim integralValue As Integer = 12534
Dim decimalValue As Decimal = Convert.ToDecimal(integralValue)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3:N2}.",
integralValue.GetType().Name,
integralValue,
decimalValue.GetType().Name,
decimalValue)
' Convert a Byte value to an Int32 value (a widening conversion).
Dim byteValue As Byte = Byte.MaxValue
Dim integralValue2 As Integer = Convert.ToInt32(byteValue)
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
byteValue.GetType().Name,
byteValue,
integralValue2.GetType().Name,
integralValue2)
' Convert a Double value to an Int32 value (a narrowing conversion).
Dim doubleValue As Double = 16.32513e12
Try
Dim longValue As Long = Convert.ToInt64(doubleValue)
Console.WriteLine("Converted the {0} value {1:E} to " +
"the {2} value {3:N0}.",
doubleValue.GetType().Name,
doubleValue,
longValue.GetType().Name,
longValue)
Catch e As OverflowException
Console.WriteLine("Unable to convert the {0:E} value {1}.",
doubleValue.GetType().Name, doubleValue)
End Try
' Convert a signed byte to a byte (a narrowing conversion).
Dim sbyteValue As SByte = -16
Try
Dim byteValue2 As Byte = Convert.ToByte(sbyteValue)
Console.WriteLine("Converted the {0} value {1} to " +
"the {2} value {3:G}.",
sbyteValue.GetType().Name,
sbyteValue,
byteValue2.GetType().Name,
byteValue2)
Catch e As OverflowException
Console.WriteLine("Unable to convert the {0} value {1}.",
sbyteValue.GetType().Name, sbyteValue)
End Try
' The example displays the following output:
' Converted the Int32 value 12534 to the Decimal value 12,534.00.
' Converted the Byte value 255 to the Int32 value 255.
' Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
' Unable to convert the SByte value -16.
Bazı durumlarda, özellikle kayan nokta değerlerine ve kayan nokta değerlerinden dönüştürme sırasında, dönüştürme işlemi bir oluşturmasa OverflowExceptionbile duyarlık kaybına neden olabilir. Aşağıdaki örnekte bu kesinlik kaybı gösterilmektedir. İlk durumda, bir Decimal değerin değerine dönüştürüldüğünde Doubledaha az duyarlık (daha az önemli basamak) vardır. İkinci durumda, dönüştürmeyi tamamlamak için bir Double değer 42,72'den 43'e yuvarlanmış olur.
double doubleValue;
// Convert a Double to a Decimal.
decimal decimalValue = 13956810.96702888123451471211m;
doubleValue = Convert.ToDouble(decimalValue);
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue);
doubleValue = 42.72;
try
{
int integerValue = Convert.ToInt32(doubleValue);
Console.WriteLine("{0} converted to {1}.",
doubleValue, integerValue);
}
catch (OverflowException)
{
Console.WriteLine("Unable to convert {0} to an integer.",
doubleValue);
}
// The example displays the following output:
// 13956810.96702888123451471211 converted to 13956810.9670289.
// 42.72 converted to 43.
Dim doubleValue As Double
' Convert a Double to a Decimal.
Dim decimalValue As Decimal = 13956810.96702888123451471211d
doubleValue = Convert.ToDouble(decimalValue)
Console.WriteLine("{0} converted to {1}.", decimalValue, doubleValue)
doubleValue = 42.72
Try
Dim integerValue As Integer = Convert.ToInt32(doubleValue)
Console.WriteLine("{0} converted to {1}.",
doubleValue, integerValue)
Catch e As OverflowException
Console.WriteLine("Unable to convert {0} to an integer.",
doubleValue)
End Try
' The example displays the following output:
' 13956810.96702888123451471211 converted to 13956810.9670289.
' 42.72 converted to 43.
Sınıfı tarafından Convert desteklenen hem genişletme hem de daraltma dönüştürmelerini listeleyen bir tablo için bkz . Tür Dönüştürme Tabloları.
ChangeType yöntemiyle özel dönüştürmeler
Temel türlerin her birine dönüştürmeleri desteklemeye ek olarak, Convert sınıfı özel bir türü önceden tanımlanmış bir veya daha fazla türe dönüştürmek için kullanılabilir. Bu dönüştürme yöntemi tarafından Convert.ChangeType(Object, Type, IFormatProvider) gerçekleştirilir ve bu da bir çağrıyı parametresinin IConvertible.ToType yöntemine value
sarmalar. Bu, parametresi tarafından temsil edilen nesnenin value
arabiriminin IConvertible bir uygulamasını sağlaması gerektiği anlamına gelir.
Not
Convert.ChangeType(Object, Type) ve Convert.ChangeType(Object, Type, IFormatProvider) yöntemleri, dönüştürülen value
hedef türü belirtmek için bir Type nesnesi kullandığından, derleme zamanında türü bilinmeyen bir nesneye dinamik dönüştürme gerçekleştirmek için kullanılabilir. Ancak uygulamasının yine de bu dönüştürmeyi IConvertible desteklemesi value
gerektiğini unutmayın.
Aşağıdaki örnek, bir TemperatureCelsius
nesnenin bir nesneye dönüştürülmesini sağlayan arabirimin IConvertible olası bir TemperatureFahrenheit
uygulamasını gösterir ve bunun tersi de geçerlidir. Örnek, Temperature
arabirimini uygulayan IConvertible ve yöntemini geçersiz kılan Object.ToString bir temel sınıfı tanımlar. Türetilen TemperatureCelsius
ve TemperatureFahrenheit
sınıflarının her biri temel sınıfın ToString
ve yöntemlerini geçersiz kılarToType
.
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
Aşağıdaki örnekte, nesneleri nesnelere TemperatureFahrenheit
dönüştürmek TemperatureCelsius
için bu IConvertible uygulamalara yapılan birkaç çağrı gösterilmektedir ve bunun tersi de geçerlidir.
TemperatureCelsius tempC1 = new TemperatureCelsius(0);
TemperatureFahrenheit tempF1 = (TemperatureFahrenheit)Convert.ChangeType(tempC1, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempF1);
TemperatureCelsius tempC2 = (TemperatureCelsius)Convert.ChangeType(tempC1, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempC1, tempC2);
TemperatureFahrenheit tempF2 = new TemperatureFahrenheit(212);
TemperatureCelsius tempC3 = (TemperatureCelsius)Convert.ChangeType(tempF2, typeof(TemperatureCelsius), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempC3);
TemperatureFahrenheit tempF3 = (TemperatureFahrenheit)Convert.ChangeType(tempF2, typeof(TemperatureFahrenheit), null);
Console.WriteLine("{0} equals {1}.", tempF2, tempF3);
// The example displays the following output:
// 0°C equals 32°F.
// 0°C equals 0°C.
// 212°F equals 100°C.
// 212°F equals 212°F.
Dim tempC1 As New TemperatureCelsius(0)
Dim tempF1 As TemperatureFahrenheit = CType(Convert.ChangeType(tempC1, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempC1, tempF1)
Dim tempC2 As TemperatureCelsius = CType(Convert.ChangeType(tempC1, GetType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempC1, tempC2)
Dim tempF2 As New TemperatureFahrenheit(212)
Dim tempC3 As TEmperatureCelsius = CType(Convert.ChangeType(tempF2, GEtType(TemperatureCelsius), Nothing), TemperatureCelsius)
Console.WriteLine("{0} equals {1}.", tempF2, tempC3)
Dim tempF3 As TemperatureFahrenheit = CType(Convert.ChangeType(tempF2, GetType(TemperatureFahrenheit), Nothing), TemperatureFahrenheit)
Console.WriteLine("{0} equals {1}.", tempF2, tempF3)
' The example displays the following output:
' 0°C equals 32°F.
' 0°C equals 0°C.
' 212°F equals 100°C.
' 212°F equals 212°F.
TypeConverter sınıfı
.NET ayrıca sınıfını genişleterek System.ComponentModel.TypeConverter ve türü dönüştürücüsü ile bir öznitelik aracılığıyla ilişkilendirerek özel bir System.ComponentModel.TypeConverterAttribute tür için tür dönüştürücüsü tanımlamanızı sağlar. Aşağıdaki tabloda, bu yaklaşım ile özel bir tür için arabirimi uygulama IConvertible arasındaki farklar vurgulanır.
Not
Tasarım zamanı desteği, yalnızca kendisi için tanımlanmış bir tür dönüştürücüsü varsa, özel bir tür için sağlanabilir.
TypeConverter kullanılarak dönüştürme | IConvertible kullanılarak dönüştürme |
---|---|
öğesinden TypeConverterayrı bir sınıf türetilerek özel bir tür için uygulanır. Bu türetilmiş sınıf, bir TypeConverterAttribute öznitelik uygulanarak özel türle ilişkilendirilir. | Dönüştürme yapmak için özel bir tür tarafından uygulanır. türündeki bir kullanıcı türü üzerinde bir IConvertible dönüştürme yöntemi çağırır. |
Hem tasarım zamanında hem de çalışma zamanında kullanılabilir. | Yalnızca çalışma zamanında kullanılabilir. |
Yansımayı kullanır; bu nedenle, tarafından IConvertibleetkinleştirilen dönüştürmeden daha yavaştır. | Yansıma kullanmaz. |
özel türden diğer veri türlerine ve diğer veri türlerinden özel türe olmak üzere, iki yönlü tür dönüştürmelerine olanak tanır. Örneğin, için tanımlanan bir TypeConverter , ve 'den StringMyType Stringöğesine dönüştürmelere MyType izin verir.MyType |
Özel bir türden diğer veri türlerine dönüştürmeye olanak tanır, fakat diğer veri türlerinden özel türe dönüştürmeye olanak tanımaz. |
Dönüştürmeleri gerçekleştirmek için tür dönüştürücüleri kullanma hakkında daha fazla bilgi için bkz System.ComponentModel.TypeConverter. .