Bagikan melalui

Konversi Tipe dalam .NET

Setiap nilai memiliki jenis terkait, yang menentukan atribut seperti jumlah ruang yang dialokasikan untuk nilai, rentang nilai yang mungkin dimilikinya, dan anggota yang disediakannya. Banyak nilai dapat dinyatakan sebagai lebih dari satu jenis. Misalnya, nilai 4 dapat dinyatakan sebagai bilangan bulat atau nilai floating-point. Konversi jenis membuat nilai dalam jenis baru yang setara dengan nilai jenis lama, tetapi tidak selalu mempertahankan identitas (atau nilai yang tepat) dari objek asli.

.NET secara otomatis mendukung konversi berikut:

  • Konversi dari kelas turunan ke kelas dasar. Ini berarti, misalnya, bahwa instans kelas atau struktur apa pun dapat dikonversi ke Object instans. Konversi ini tidak memerlukan operator pengecoran atau konversi.

  • Konversi dari kelas dasar kembali ke kelas turunan asli. Dalam C#, konversi ini memerlukan operator cast. Di Visual Basic, dibutuhkan operator CType jika Option Strict aktif.

  • Konversi dari jenis yang mengimplementasikan antarmuka ke objek antarmuka yang mewakili antarmuka tersebut. Konversi ini tidak memerlukan operator pengecoran atau konversi.

  • Konversi dari objek antarmuka kembali ke jenis asli yang mengimplementasikan antarmuka tersebut. Dalam C#, konversi ini memerlukan operator cast. Di Visual Basic, dibutuhkan operator CType jika Option Strict aktif.

Selain konversi otomatis ini, .NET menyediakan beberapa fitur yang mendukung konversi jenis kustom. Ini termasuk yang berikut ini:

Konversi implisit dengan operator implisit

Konversi perluasan melibatkan pembuatan nilai baru dari nilai tipe yang ada yang rentangnya lebih terbatas atau daftar elemennya lebih terbatas dibandingkan tipe sasaran. Konversi yang melebar tidak dapat mengakibatkan kehilangan data (meskipun dapat mengakibatkan hilangnya presisi). Karena data tidak dapat hilang, pengkompilasi dapat menangani konversi secara implisit atau transparan, tanpa memerlukan penggunaan metode konversi eksplisit atau operator transmisi.

Nota

Meskipun kode yang melakukan konversi implisit dapat memanggil metode konversi atau menggunakan operator transmisi, penggunaannya tidak diperlukan oleh kompilator yang mendukung konversi implisit.

Misalnya, tipe Decimal mendukung konversi implisit dari nilai Byte, Char, Int16, Int32, Int64, SByte, UInt16, UInt32, dan UInt64. Contoh berikut mengilustrasikan beberapa konversi implisit ini dalam menetapkan nilai ke Decimal variabel.

  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.

Jika pengkompilasi bahasa tertentu mendukung operator kustom, Anda juga dapat menentukan konversi implisit dalam jenis kustom Anda sendiri. Contoh berikut menyediakan implementasi parsial dari jenis data byte yang ditandatangani bernama ByteWithSign yang menggunakan representasi sign-and-magnitude. Ini mendukung konversi implisit dari nilai Byte dan SByte menjadi nilai ByteWithSign.

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

    public static implicit operator ByteWithSign(SByte value)
    {
        ByteWithSign newValue;
        newValue.signValue = (SByte)Math.Sign(value);
        newValue.value = (byte)Math.Abs(value);
        return newValue;
    }

    public static implicit operator ByteWithSign(Byte value)
    {
        ByteWithSign newValue;
        newValue.signValue = 1;
        newValue.value = value;
        return newValue;
    }

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

Public Structure ImplicitByteWithSign
    Private signValue As SByte
    Private value As Byte

    Public Overloads Shared Widening Operator CType(value As SByte) As ImplicitByteWithSign
        Dim newValue As ImplicitByteWithSign
        newValue.signValue = CSByte(Math.Sign(value))
        newValue.value = CByte(Math.Abs(value))
        Return newValue
    End Operator

    Public Overloads Shared Widening Operator CType(value As Byte) As ImplicitByteWithSign
        Dim NewValue As ImplicitByteWithSign
        newValue.signValue = 1
        newValue.value = value
        Return newValue
    End Operator

    Public Overrides Function ToString() As String
        Return (signValue * value).ToString()
    End Function
End Structure

Kode klien kemudian dapat mendeklarasikan ByteWithSign variabel dan menetapkannya Byte dan SByte nilai tanpa melakukan konversi eksplisit atau menggunakan operator transmisi apa pun, seperti yang ditunjukkan contoh berikut.

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

Konversi eksplisit dengan operator eksplisit

Konversi penyempitan melibatkan pembuatan nilai baru dari nilai tipe yang sudah ada yang memiliki rentang lebih luas atau daftar anggota lebih banyak daripada tipe target. Karena konversi yang dipersempit dapat mengakibatkan hilangnya data, pengkompilasi sering mengharuskan konversi dibuat secara eksplisit melalui panggilan ke metode konversi atau operator transmisi. Artinya, konversi harus ditangani secara eksplisit dalam kode pengembang.

Nota

Tujuan utama membutuhkan metode konversi atau operator casting untuk mempersempit konversi adalah untuk membuat pengembang mengetahui kemungkinan kehilangan data atau OverflowException sehingga dapat ditangani dalam kode. Namun, beberapa kompilator dapat melonggarkan persyaratan ini. Misalnya, di Visual Basic, jika Option Strict nonaktif (pengaturan defaultnya), pengkompilasi Visual Basic mencoba melakukan konversi penyempitan secara implisit.

Misalnya, UInt32jenis data , Int64, dan UInt64 memiliki rentang yang melebihi Int32 jenis data, seperti yang ditunjukkan oleh tabel berikut ini.

Tipe Perbandingan dengan rentang Int32
Int64 Int64.MaxValue lebih besar dari Int32.MaxValue, dan Int64.MinValue kurang dari (memiliki rentang negatif yang lebih besar dari) Int32.MinValue.
UInt32 UInt32.MaxValue lebih besar dari Int32.MaxValue.
UInt64 UInt64.MaxValue lebih besar dari Int32.MaxValue.

Untuk menangani konversi yang menyempit seperti itu, .NET memungkinkan tipe untuk menentukan Explicit operator. Pengkompilasi bahasa individual kemudian dapat mengimplementasikan operator ini menggunakan sintaksnya sendiri, atau anggota Convert kelas dapat dipanggil untuk melakukan konversi. (Untuk informasi selengkapnya tentang Convert kelas , lihat Kelas Konversi nanti dalam topik ini.) Contoh berikut mengilustrasikan penggunaan fitur bahasa untuk menangani konversi eksplisit dari nilai bilangan bulat yang berpotensi di luar rentang ini ke Int32 nilai.

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.

Konversi eksplisit dapat menghasilkan hasil yang berbeda dalam bahasa yang berbeda, dan hasil ini dapat berbeda dari nilai yang dikembalikan oleh metode yang Convert sesuai. Misalnya, jika Double nilai 12,63251 dikonversi ke Int32, baik metode Visual Basic CInt maupun metode .NET Convert.ToInt32(Double) membulatkan Double untuk mengembalikan nilai 13, tetapi operator C# (int) memotong Double untuk mengembalikan nilai 12. Demikian pula, operator C# (int) tidak mendukung konversi Boolean-ke-bilangan bulat, tetapi metode Visual Basic CInt mengonversi nilai true menjadi -1. Di sisi lain, metode ini mengonversi nilai dari Convert.ToInt32(Boolean) menjadi 1.

Sebagian besar kompilator memungkinkan konversi eksplisit dilakukan dengan cara yang dicentang atau tidak dicentang. Ketika konversi yang diawasi dilakukan, OverflowException dilemparkan ketika nilai jenis yang akan dikonversi berada di luar rentang jenis target. Ketika konversi yang tidak dicentang dilakukan dalam kondisi yang sama, konversi mungkin tidak melemparkan pengecualian, tetapi perilaku yang tepat menjadi tidak terdefinisi dan nilai yang salah mungkin dihasilkan.

Nota

Di C#, konversi yang diperiksa dapat dilakukan dengan menggunakan checked kata kunci bersama dengan operator cast, atau dengan menentukan /checked+ opsi kompilator. Sebaliknya, konversi tanpa pengecekan dapat dilakukan dengan menggunakan kata kunci unchecked bersama dengan operator pengubahan tipe, atau dengan menentukan opsi kompilator /checked-. Secara default, konversi eksplisit tidak dicentang. Di Visual Basic, konversi yang dicentang dapat dilakukan dengan mengosongkan kotak centang Hapus luapan bilangan bulat dalam kotak dialog Pengaturan Pengkompilasi Tingkat Lanjut proyek, atau dengan menentukan /removeintchecks- opsi pengkompilasi. Sebaliknya, konversi yang tidak dicentang dapat dilakukan dengan memilih kotak centang Hapus aliran bilangan bulat di kotak dialog Pengaturan Pengkompilasi Tingkat Lanjut proyek atau dengan menentukan /removeintchecks+ opsi pengkompilasi. Secara bawaan, konversi eksplisit diperiksa.

Contoh C# berikut menggunakan kata kunci checked dan unchecked untuk mengilustrasikan perbedaan perilaku ketika nilai di luar rentang Byte dikonversi menjadi Byte. Konversi yang diperiksa menghasilkan pengecualian, tetapi konversi yang tidak dicentang menetapkan Byte.MaxValue ke variabel Byte.

int largeValue = Int32.MaxValue;
byte newValue;

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

try
{
    newValue = checked((byte)largeValue);
    Console.WriteLine($"Converted the {largeValue.GetType().Name} value {largeValue} to the {newValue.GetType().Name} value {newValue}.");
}
catch (OverflowException)
{
    Console.WriteLine($"{largeValue} is outside the range of the Byte data type.");
}
// The example displays the following output:
//    Converted the Int32 value 2147483647 to the Byte value 255.
//    2147483647 is outside the range of the Byte data type.

Jika pengkompilasi bahasa tertentu mendukung operator yang kelebihan beban kustom, Anda juga dapat menentukan konversi eksplisit dalam jenis kustom Anda sendiri. Contoh berikut menyediakan implementasi parsial dari jenis data byte yang ditandatangani bernama ByteWithSign yang menggunakan representasi sign-and-magnitude. Ini mendukung konversi eksplisit nilai Int32 dan UInt32 menjadi nilai ByteWithSign.

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

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

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

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

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

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

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

Public Structure ByteWithSign
    Private signValue As SByte
    Private value As Byte

    Private Const MaxValue As Byte = Byte.MaxValue
    Private Const MinValue As Integer = -1 * Byte.MaxValue

    Public Overloads Shared Narrowing Operator CType(value As Integer) As ByteWithSign
        ' Check for overflow.
        If value > ByteWithSign.MaxValue Or value < ByteWithSign.MinValue Then
            Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
        End If

        Dim newValue As ByteWithSign

        newValue.signValue = CSByte(Math.Sign(value))
        newValue.value = CByte(Math.Abs(value))
        Return newValue
    End Operator

    Public Overloads Shared Narrowing Operator CType(value As UInteger) As ByteWithSign
        If value > ByteWithSign.MaxValue Then
            Throw New OverflowException(String.Format("'{0}' is out of range of the ByteWithSign data type.", value))
        End If

        Dim NewValue As ByteWithSign

        newValue.signValue = 1
        newValue.value = CByte(value)
        Return newValue
    End Operator

    Public Overrides Function ToString() As String
        Return (signValue * value).ToString()
    End Function
End Structure

Kode klien kemudian dapat mendeklarasikan variabel ByteWithSign dan menugaskannya dengan nilai Int32 dan UInt32 jika penugasan termasuk operator casting atau metode konversi, contoh berikut menunjukkan.

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.

Antarmuka IConvertible

Untuk mendukung konversi semua jenis ke jenis dasar Common Language Runtime, .NET menyediakan antarmuka IConvertible. Jenis penerapan diperlukan untuk memberikan hal berikut:

  • Metode yang mengembalikan TypeCode dari tipe yang diimplementasikan.

  • Metode untuk mengonversi jenis pengimplementasian ke setiap jenis dasar runtime bahasa umum (Boolean, Byte, DateTime, Decimal, Double, dan sebagainya).

  • Metode konversi umum untuk mengonversi instans jenis penerapan ke jenis lain yang ditentukan. Konversi yang tidak didukung harus menghasilkan InvalidCastException.

Setiap tipe dasar dari runtime bahasa umum (yaitu, Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, UInt16, UInt32, dan UInt64), serta tipe DBNull dan Enum, mengimplementasikan antarmuka IConvertible. Namun, ini adalah implementasi antarmuka eksplisit; metode konversi hanya dapat dipanggil melalui IConvertible variabel antarmuka, seperti yang ditunjukkan contoh berikut. Contoh ini mengonversi Int32 nilai ke nilai yang setara Char .

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

Dim codePoint As Integer = 1067
Dim iConv As IConvertible = codePoint
Dim ch As Char = iConv.ToChar(Nothing)
Console.WriteLine("Converted {0} to {1}.", codePoint, ch)

Persyaratan untuk memanggil metode konversi pada antarmukanya daripada pada jenis penerapan membuat implementasi antarmuka eksplisit relatif mahal. Sebagai gantinya, kami sarankan Anda memanggil anggota kelas Convert yang sesuai untuk mengonversi antara jenis dasar waktu proses bahasa umum. Untuk informasi selengkapnya, lihat bagian berikutnya, Kelas Konversi.

Nota

Selain IConvertible antarmuka dan Convert kelas yang disediakan oleh .NET, bahasa individual juga dapat menyediakan cara untuk melakukan konversi. Misalnya, C# menggunakan operator transmisi; Visual Basic menggunakan fungsi konversi yang diimplementasikan kompilator seperti CType, , CIntdan DirectCast.

Sebagian besar, IConvertible antarmuka dirancang untuk mendukung konversi antara jenis dasar di .NET. Namun, antarmuka juga dapat diimplementasikan oleh jenis kustom untuk mendukung konversi jenis tersebut ke jenis kustom lainnya. Untuk informasi selengkapnya, lihat bagian Konversi Kustom dengan Metode ChangeType nanti dalam topik ini.

Kelas Konversi

Meskipun implementasi antarmuka dari setiap jenis dasar IConvertible dapat dipanggil untuk melakukan konversi jenis, memanggil metode kelas System.Convert adalah cara yang direkomendasikan dan netral dari segi bahasa untuk mengonversi dari satu jenis dasar ke jenis dasar lainnya. Selain itu, Convert.ChangeType(Object, Type, IFormatProvider) metode ini dapat digunakan untuk mengonversi dari jenis kustom tertentu ke jenis lain.

Konversi antar jenis dasar

Kelas ini Convert menyediakan cara yang netral terhadap bahasa untuk melakukan konversi antara jenis dasar dan tersedia untuk semua bahasa yang menggunakan common language runtime. Ini menyediakan serangkaian metode lengkap untuk konversi yang melebarkan dan mempersempit, dan melempar InvalidCastException untuk konversi yang tidak didukung (seperti konversi nilai DateTime ke nilai bilangan bulat). Konversi penyempitan dilakukan dalam konteks yang diawasi, dan OverflowException dilemparkan jika konversi gagal.

Penting

Convert Karena kelas ini mencakup metode untuk mengonversi ke dan dari setiap jenis dasar, hal ini menghilangkan kebutuhan untuk memanggil implementasi antarmuka eksplisit dari setiap jenis IConvertible dasar.

Contoh berikut mengilustrasikan penggunaan System.Convert kelas untuk melakukan beberapa konversi yang melebar dan mempersempit antara jenis dasar .NET.

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

// Convert a Double value to an Int32 value (a narrowing conversion).
double doubleValue = 16.32513e12;
try
{
    long longValue = Convert.ToInt64(doubleValue);
    Console.WriteLine($"Converted the {doubleValue.GetType().Name} value {doubleValue:E} to " +
                                      "the {longValue.GetType().Name} value {longValue:N0}.");
}
catch (OverflowException)
{
    Console.WriteLine($"Unable to convert the {doubleValue.GetType().Name:E} value {doubleValue}.");
}

// Convert a signed byte to a byte (a narrowing conversion).
sbyte sbyteValue = -16;
try
{
    byte byteValue2 = Convert.ToByte(sbyteValue);
    Console.WriteLine($"Converted the {sbyteValue.GetType().Name} value {sbyteValue} to " +
                                      "the {byteValue2.GetType().Name} value {byteValue2:G}.");
}
catch (OverflowException)
{
    Console.WriteLine($"Unable to convert the {sbyteValue.GetType().Name} value {sbyteValue}.");
}
// The example displays the following output:
//       Converted the Int32 value 12534 to the Decimal value 12,534.00.
//       Converted the Byte value 255 to the Int32 value 255.
//       Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
//       Unable to convert the SByte value -16.

' Convert an Int32 value to a Decimal (a widening conversion).
Dim integralValue As Integer = 12534
Dim decimalValue As Decimal = Convert.ToDecimal(integralValue)
Console.WriteLine("Converted the {0} value {1} to the {2} value {3:N2}.",
                  integralValue.GetType().Name,
                  integralValue,
                  decimalValue.GetType().Name,
                  decimalValue)

' Convert a Byte value to an Int32 value (a widening conversion).
Dim byteValue As Byte = Byte.MaxValue
Dim integralValue2 As Integer = Convert.ToInt32(byteValue)
Console.WriteLine("Converted the {0} value {1} to " +
                                  "the {2} value {3:G}.",
                                  byteValue.GetType().Name,
                                  byteValue,
                                  integralValue2.GetType().Name,
                                  integralValue2)

' Convert a Double value to an Int32 value (a narrowing conversion).
Dim doubleValue As Double = 16.32513e12
Try
    Dim longValue As Long = Convert.ToInt64(doubleValue)
    Console.WriteLine("Converted the {0} value {1:E} to " +
                                      "the {2} value {3:N0}.",
                                      doubleValue.GetType().Name,
                                      doubleValue,
                                      longValue.GetType().Name,
                                      longValue)
Catch e As OverflowException
    Console.WriteLine("Unable to convert the {0:E} value {1}.",
                                      doubleValue.GetType().Name, doubleValue)
End Try

' Convert a signed byte to a byte (a narrowing conversion).     
Dim sbyteValue As SByte = -16
Try
    Dim byteValue2 As Byte = Convert.ToByte(sbyteValue)
    Console.WriteLine("Converted the {0} value {1} to " +
                                      "the {2} value {3:G}.",
                                      sbyteValue.GetType().Name,
                                      sbyteValue,
                                      byteValue2.GetType().Name,
                                      byteValue2)
Catch e As OverflowException
    Console.WriteLine("Unable to convert the {0} value {1}.",
                                      sbyteValue.GetType().Name, sbyteValue)
End Try
' The example displays the following output:
'       Converted the Int32 value 12534 to the Decimal value 12,534.00.
'       Converted the Byte value 255 to the Int32 value 255.
'       Converted the Double value 1.632513E+013 to the Int64 value 16,325,130,000,000.
'       Unable to convert the SByte value -16.

Dalam beberapa kasus, terutama saat mengonversi ke dan dari nilai floating-point, konversi dapat menyebabkan hilangnya ketelitian, meskipun tidak menghasilkan OverflowException. Contoh berikut mengilustrasikan hilangnya presisi ini. Dalam kasus pertama, Decimal nilai memiliki presisi yang lebih sedikit (digit yang lebih sedikit signifikan) ketika dikonversi ke Double. Dalam kasus kedua, Double nilai dibulatkan dari 42,72 hingga 43 untuk menyelesaikan konversi.

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.

Untuk tabel yang mencantumkan konversi pelebaran dan penyempitan yang didukung oleh kelas Convert, lihat Tabel Konversi Tipe.

Konversi kustom dengan metode ChangeType

Selain mendukung konversi ke masing-masing jenis dasar, Convert kelas dapat digunakan untuk mengonversi jenis kustom menjadi satu atau beberapa jenis yang telah ditentukan sebelumnya. Konversi ini dilakukan oleh metode Convert.ChangeType(Object, Type, IFormatProvider), yang pada gilirannya memanggil metode IConvertible.ToType dari parameter value. Ini berarti bahwa objek yang diwakili oleh value parameter harus menyediakan implementasi IConvertible antarmuka.

Nota

Convert.ChangeType(Object, Type) Karena metode dan Convert.ChangeType(Object, Type, IFormatProvider) menggunakan Type objek untuk menentukan jenis target yang value dikonversi, metode tersebut dapat digunakan untuk melakukan konversi dinamis ke objek yang jenisnya tidak diketahui pada waktu kompilasi. Namun, perhatikan bahwa IConvertible implementasi value harus tetap mendukung konversi ini.

Contoh berikut mengilustrasikan kemungkinan implementasi IConvertible antarmuka yang memungkinkan TemperatureCelsius objek dikonversi ke TemperatureFahrenheit objek dan sebaliknya. Contoh mendefinisikan kelas dasar, Temperature, yang mengimplementasikan antarmuka IConvertible dan menimpa metode Object.ToString. Kelas turunan TemperatureCelsius dan TemperatureFahrenheit masing-masing menggantikan metode ToType dan ToString dari kelas dasar.

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

Contoh berikut mengilustrasikan beberapa panggilan ke implementasi ini IConvertible untuk mengonversi TemperatureCelsius objek ke TemperatureFahrenheit objek dan sebaliknya.

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.

Kelas TypeConverter

.NET juga memungkinkan Anda menentukan pengonversi jenis untuk jenis kustom dengan memperluas System.ComponentModel.TypeConverter kelas dan mengaitkan pengonversi jenis dengan jenis melalui System.ComponentModel.TypeConverterAttribute atribut. Tabel berikut menyoroti perbedaan antara pendekatan ini dan menerapkan IConvertible antarmuka untuk jenis kustom.

Nota

Dukungan waktu desain dapat disediakan untuk tipe khusus hanya jika memiliki pengonversi tipe yang ditentukan untuknya.

Konversi menggunakan TypeConverter Konversi menggunakan IConvertible
Diimplementasikan untuk jenis kustom dengan mendapatkan kelas terpisah dari TypeConverter. Kelas turunan ini dikaitkan dengan jenis kustom dengan menerapkan TypeConverterAttribute atribut. Diimplementasikan oleh tipe khusus untuk melakukan konversi. Pengguna dari jenis tersebut memanggil metode konversi pada jenis tersebut.
Dapat digunakan baik pada waktu desain maupun pada waktu proses. Hanya dapat digunakan saat runtime.
Menggunakan pantulan; oleh karena itu, lebih lambat daripada konversi yang diaktifkan oleh IConvertible. Tidak menggunakan pantulan.
Memungkinkan konversi jenis dua arah dari jenis kustom ke jenis data lain, dan dari jenis data lain ke jenis kustom. Misalnya, yang TypeConverter ditentukan untuk MyType memungkinkan konversi dari MyType ke String, dan dari String ke MyType. Memungkinkan konversi dari jenis kustom ke jenis data lain, tetapi tidak dari jenis data lain ke jenis kustom.

Untuk informasi selengkapnya tentang menggunakan pengonversi jenis untuk melakukan konversi, lihat System.ComponentModel.TypeConverter.

Lihat juga

  • Last updated on