Aracılığıyla paylaş

.NET'te 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 birden fazla tür olarak ifade edilebilir. Örneğin, 4 değeri tamsayı veya kayan nokta değeri olarak ifade edilebilir. Tür dönüştürme, yeni bir türde eski bir türün değerine eşdeğer bir değer oluşturur, ancak özgün nesnenin kimliğini (veya tam değerini) korumaz.

.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 kast 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 dönüştürme işleci gerekir. Visual Basic'te, CType açıksa, Option Strict işleci gerektirir.

  • Arabirimi uygulayan bir türden bu arabirimi temsil eden bir arabirim nesnesine dönüştürme. Bu dönüştürme için bir kast 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 dönüştürme işleci gerekir. Visual Basic'te, CType açıksa, Option Strict işleci gerektirir.

.NET, bu otomatik dönüştürmelere ek olarak özel tür dönüştürmeyi destekleyen çeşitli özellikler sağlar. Bunlar şunları içerir:

Örtük işleçle örtük dönüştürme

Genişletme dönüştürmeleri, hedef türe göre daha kısıtlayıcı bir aralığa veya daha kısıtlanmış üye listesine sahip mevcut bir türün değerinden yeni bir değer oluşturulmasını içerir. Genişletme dönüştürmeleri veri kaybına neden olamaz (ancak kesinlik kaybına neden olabilir). Veriler kaybedilemediğinden, derleyiciler açık dönüştürme yönteminin veya atama işlecinin kullanılmasına gerek kalmadan dönüştürmeyi örtük veya saydam olarak işleyebilir.

Uyarı

Örtük dönüştürme gerçekleştiren kod bir dönüştürme yöntemini çağırabilir veya bir atama işleci kullanabilir, ancak bunların kullanımı örtük dönüştürmeleri destekleyen derleyiciler tarafından gerekli değildir.

Örneğin, Decimal türü, Byte, Char, Int16, Int32, Int64, SByte, UInt16, UInt32 ve UInt64 değerlerinden ö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 destekliyorsa, kendi özel türlerinizde örtük dönüştürmeler de tanımlayabilirsiniz. Aşağıdaki örnek, sign-and-magnitude gösterimi kullanan ByteWithSign adlı işaretli bayt veri türünün kısmi bir uygulamasını gösterir. Byte ve SByte değerlerinin ByteWithSign değerlere örtük olarak dönüştürülmesini 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 ByteWithSign değişkeni bildirebilir ve aşağıdaki örnekte gösterildiği gibi, herhangi bir açık dönüştürme veya dönüştürme işlemcisi kullanmadan ona Byte ve SByte değerlerini atayabilir.

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 operatörle açık dönüştürme

Daraltma dönüştürmeleri, var olan bir türün değerinden hedef türden daha büyük bir aralık veya daha büyük bir üye listesi içeren yeni bir değer oluşturulmasını içerir. Daraltma dönüştürmesi veri kaybına neden olabileceğinden, derleyiciler genellikle dönüşüm yönteminin veya dönüşüm operatörünün çağrısı aracılığıyla dönüştürmenin açıkça yapılmasını gerektirir. Yani dönüştürme, geliştirici kodunda açıkça işlenmelidir.

Uyarı

Daraltıcı dönüşümler için bir dönüştürme yöntemi veya dönüştürme işleci gerektirmenin temel amacı, geliştiriciyi veri kaybı olasılığı veya OverflowException konusunda bilgilendirerek, bu durumun kodda ele alınabilmesini sağlamaktır. Ancak, bazı derleyiciler bu gereksinimi gevşetebilir. Örneğin, Visual Basic'te Option Strict kapalıysa (varsayılan ayarı), Visual Basic derleyicisi örtük olarak daraltıcı dönüşümler gerçekleştirmeye çalışır.

Örneğin, UInt32, Int64 ve UInt64 veri türlerinin aralıkları, Int32 veri türünün aralığını aşıyor, aşağıdaki tabloda gösterildiği gibi.

Türü Int32 aralığıyla karşılaştırma
Int64 Int64.MaxValue değeri Int32.MaxValue değerinden büyüktür ve Int64.MinValue değeri Int32.MinValue değerinden küçüktür (daha geniş bir negatif aralığa sahiptir).
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 Convert Sınıfı 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: {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.

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 Double değerine dönüştürülürse, hem Visual Basic Int32 yöntemi hem de .NET CInt yöntemi Convert.ToInt32(Double) değerini yuvarlayarak 13 değeri döndürür, ancak C# Double operatörü (int) değerini keser ve 12 değeri döndürür. 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, true değerini 1'e dönüştürür.

Çoğu derleyici, açık dönüştürmelerin işaretli veya işaretsiz bir şekilde gerçekleştirilmesine izin verir. Dönüştürülecek türün değeri hedef türün aralığının dışında olduğunda, işaretli dönüştürme gerçekleştirildiğinde bir OverflowException fırlatılır. Belirtilen koşullar altında işaretlenmemiş bir dönüştürme gerçekleştirildiğinde, dönüştürme bir özel durum oluşturmayabilir, ancak kesin davranış tanımsız hale gelir ve yanlış bir değerle sonuçlanabilir.

Uyarı

C# dilinde, checked anahtar sözcüğü bir dönüştürme işleciyle birlikte kullanılarak ya da /checked+ derleyici seçeneği belirtilerek denetlenmiş dönüştürmeler gerçekleştirilebilir. Buna karşılık, casting işleciyle birlikte unchecked anahtar sözcüğü kullanılarak veya /checked- derleyici seçeneği belirtilerek denetlenmeyen 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 denetlenmektedir.

Aşağıdaki C# örneği, checked ve unchecked anahtar sözcüklerini, bir Byte aralığındaki değerin aralığın dışındaki bir değere Byte dönüştürüldüğünde davranış farkını göstermek için kullanır. Denetimli dönüştürme bir özel durum oluştururken, denetlenmeyen dönüştürme Byte.MaxValue değerini Byte değişkenine atar.

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.

Belirli bir dil derleyicisi özel aşırı yüklenmiş işleçleri destekliyorsa, kendi özel türlerinizde açık dönüştürmeler de tanımlayabilirsiniz. Aşağıdaki örnek, sign-and-magnitude gösterimi kullanan ByteWithSign adlı işaretli bayt veri türünün kısmi bir uygulamasını gösterir. Int32 ve UInt32 değerlerinin ByteWithSign değerlere açıkça dönüştürülmesini 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, atamalar bir dönüştürme işleci veya yöntem içeriyorsa, aşağıdaki örnekte gösterildiği gibi bir ByteWithSign değişkenini bildirip bu değişkene Int32 ve UInt32 değerlerini 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ü aşağıdakileri sağlamak için gereklidir:

  • Uygulama türünün TypeCode değerini döndüren 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 belirtilen başka bir türe dönüştürmek için genelleştirilmiş dönüştürme yöntemi. Desteklenmeyen dönüştürmeler bir InvalidCastException oluşturmalıdır.

Her ortak dil çalışma zamanı temel türü (yani Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32, ve UInt64) ile DBNull ve Enum türleri, IConvertible arabirimini uygular. 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 {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)

Uygulama türü yerine arabiriminde dönüştürme yöntemini çağırma gereksinimi, açık arabirim uygulamalarını nispeten pahalı hale getirir. Bunun yerine, ortak dil çalışma zamanı temel türleri arasında dönüştürmek için Convert sınıfının uygun üyesini çağırmanızı öneririz. Daha fazla bilgi için, sonraki Convert Sınıfı bölümüne bakın.

Uyarı

.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, , CTypeve CIntgibi DirectCastderleyici 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, bir türün diğer özel türlere dönüştürülmesini desteklemek için arabirim, ö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 ne kadar her temel türün IConvertible arabirim uygulaması bir tür dönüşümü gerçekleştirmek için çağrılabilse de, bir temel türden diğerine dönüştürmek için önerilen dil nötr yol, System.Convert sınıfının yöntemlerini çağırmaktır. 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 desteklenmeyen dönüştürmeler için (bir InvalidCastException değerinin 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 OverflowException atılır.

Ö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 {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.

Bazı durumlarda, özellikle kayan nokta değerlerine ve değerlerden yapılan dönüşümlerde, dönüştürme işlemi OverflowException oluşturmasa bile duyarlık kaybına neden olabilir. Aşağıdaki örnekte bu duyarlık kaybı gösterilmektedir. İlk durumda, bir Decimal değeri Double'ye dönüştürüldüğünde daha 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($"{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.

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, parametrenin Convert.ChangeType(Object, Type, IFormatProvider) yöntemine bir çağrı saran IConvertible.ToType yönteminin value tarafından gerçekleştirilir. Bu, parametresi tarafından temsil edilen nesnenin value arabiriminin IConvertible bir uygulamasını sağlaması gerektiği anlamına gelir.

Uyarı

Convert.ChangeType(Object, Type) ve Convert.ChangeType(Object, Type, IFormatProvider) yöntemleri, dönüştürülen Type hedef türü belirtmek için bir value nesnesi kullandığından, derleme zamanında türü bilinmeyen bir nesneye dinamik dönüştürme gerçekleştirmek için kullanılabilir. Ancak, IConvertible uygulamasının yine de bu dönüştürmeyi value desteklemesi gerektiğini unutmayın.

Aşağıdaki örnek, bir IConvertible nesnesinin bir TemperatureCelsius nesnesine ve tersine dönüştürülmesine olanak tanıyan TemperatureFahrenheit arabiriminin olası bir uygulamasını gösterir. Örnek, Temperature arabirimini uygulayan ve IConvertible yöntemini ezen bir Object.ToString temel sınıfı tanımlar. Türetilen TemperatureCelsius ve TemperatureFahrenheit sınıflarının her biri temel sınıfın ToType ve yöntemlerini geçersiz kılarToString.

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 örnek, IConvertible nesnelerini TemperatureCelsius nesnelerine ve tam tersi yönde dönüştürmek için bu TemperatureFahrenheit uygulamalarına yapılan birkaç çağrıyı göstermektedir.

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.

TypeConverter sınıfı

.NET ayrıca System.ComponentModel.TypeConverter sınıfını genişleterek ve System.ComponentModel.TypeConverterAttribute özniteliği aracılığıyla tür dönüştürücüsünü türle ilişkilendirerek özel bir tür için tür dönüştürücüsü tanımlamanıza olanak tanır. Aşağıdaki tabloda, bu yaklaşım ile özel bir tür için IConvertible arabiriminin uygulanması arasındaki farklar vurgulanır.

Uyarı

Özel bir tür için tasarım zamanı desteği, yalnızca bunun için tanımlanmış bir tür dönüştürücüsü varsa sağlanabilir.

TypeConverter kullanarak dönüştürme IConvertible kullanarak 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 gerçekleştirmek için özel bir tip tarafından uygulanır. Türün bir kullanıcısı, tür üzerinde bir IConvertible dönüşüm 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ıma kullanır; bu nedenle, IConvertible tarafından etkinleştirilen dönüştürmeye göre daha yavaştır. Yansıma kullanmaz.
Özel türden diğer veri türlerine ve diğer veri türlerinden özel türe iki yönlü tür dönüştürmelerine izin verir. Örneğin, TypeConverter için tanımlanan bir MyType, MyType öğesinden String öğesine ve String öğesinden MyType öğesine dönüştürmelere izin verir. Özel bir türden diğer veri türlerine dönüştürmeye izin verir, ancak diğer veri türlerinden özel türe dönüştürmeye izin vermez.

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

Ayrıca bkz.

  • Last updated on