DynamicObject.TryConvert(ConvertBinder, Object) Metode

Definisi

Ruang nama:

System.Dynamic

Rakitan:

System.Linq.Expressions.dll

Sumber:

DynamicObject.cs

Menyediakan implementasi untuk operasi konversi jenis. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi yang mengonversi objek dari satu jenis ke jenis lainnya.

public:
 virtual bool TryConvert(System::Dynamic::ConvertBinder ^ binder, [Runtime::InteropServices::Out] System::Object ^ % result);

public virtual bool TryConvert (System.Dynamic.ConvertBinder binder, out object? result);

abstract member TryConvert : System.Dynamic.ConvertBinder * obj -> bool
override this.TryConvert : System.Dynamic.ConvertBinder * obj -> bool

Public Overridable Function TryConvert (binder As ConvertBinder, ByRef result As Object) As Boolean

Parameter

binder

ConvertBinder

Menyediakan informasi tentang operasi konversi. Properti binder.Type menyediakan jenis objek yang harus dikonversi. Misalnya, untuk pernyataan (String)sampleObject dalam C# (CType(sampleObject, Type) di Visual Basic), di mana sampleObject adalah instans kelas yang berasal dari DynamicObject kelas , binder.Type mengembalikan jenis .String Properti binder.Explicit menyediakan informasi tentang jenis konversi yang terjadi. Ini mengembalikan konversi eksplisit dan false untuk konversi implisittrue.

result

Object

Hasil operasi konversi jenis.

Mengembalikan

Boolean

true jika operasi berhasil; jika tidak, false. Jika metode ini mengembalikan false, pengikat run-time bahasa menentukan perilaku. (Dalam kebanyakan kasus, pengecualian run-time khusus bahasa dilemparkan.)

Contoh

Asumsikan bahwa Anda memerlukan struktur data untuk menyimpan representasi tekstual dan numerik angka, dan Anda ingin menentukan konversi struktur data ini ke string dan bilangan bulat.

Contoh kode berikut menunjukkan DynamicNumber kelas , yang berasal dari DynamicObject kelas . DynamicNumber mengambil alih TryConvert metode untuk mengaktifkan konversi jenis. Ini juga mengambil alih TrySetMember metode dan TryGetMember untuk mengaktifkan akses ke elemen data.

Dalam contoh ini, hanya konversi ke string dan bilangan bulat yang didukung. Jika Anda mencoba mengonversi objek ke jenis lain, pengecualian run-time akan dilemparkan.

// The class derived from DynamicObject.
public class DynamicNumber : DynamicObject
{
    // The inner dictionary.
    Dictionary<string, object> dictionary
        = new Dictionary<string, object>();

    // Getting a property.
    public override bool TryGetMember(
        GetMemberBinder binder, out object result)
    {
        return dictionary.TryGetValue(binder.Name, out result);
    }

    // Setting a property.
    public override bool TrySetMember(
        SetMemberBinder binder, object value)
    {
        dictionary[binder.Name] = value;
        return true;
    }

    // Converting an object to a specified type.
    public override bool TryConvert(
        ConvertBinder binder, out object result)
    {
        // Converting to string.
        if (binder.Type == typeof(String))
        {
            result = dictionary["Textual"];
            return true;
        }

        // Converting to integer.
        if (binder.Type == typeof(int))
        {
            result = dictionary["Numeric"];
            return true;
        }

        // In case of any other type, the binder
        // attempts to perform the conversion itself.
        // In most cases, a run-time exception is thrown.
        return base.TryConvert(binder, out result);
    }
}

class Program
{
    static void Test(string[] args)
    {
        // Creating the first dynamic number.
        dynamic number = new DynamicNumber();

        // Creating properties and setting their values
        // for the dynamic number.
        // The TrySetMember method is called.
        number.Textual = "One";
        number.Numeric = 1;

        // Implicit conversion to integer.
        int testImplicit = number;

        // Explicit conversion to string.
        string testExplicit = (String)number;

        Console.WriteLine(testImplicit);
        Console.WriteLine(testExplicit);

        // The following statement produces a run-time exception
        // because the conversion to double is not implemented.
        // double test = number;
    }
}

// This example has the following output:

// 1
// One

' Add Imports System.Linq.Expressions
' to the beginning of the file.
' The class derived from DynamicObject.
Public Class DynamicNumber
    Inherits DynamicObject

    ' The inner dictionary to store field names and values.
    Dim dictionary As New Dictionary(Of String, Object)

    ' Get the property value.
    Public Overrides Function TryGetMember(
        ByVal binder As System.Dynamic.GetMemberBinder,
        ByRef result As Object) As Boolean

        Return dictionary.TryGetValue(binder.Name, result)

    End Function

    ' Set the property value.
    Public Overrides Function TrySetMember(
        ByVal binder As System.Dynamic.SetMemberBinder,
        ByVal value As Object) As Boolean

        dictionary(binder.Name) = value
        Return True

    End Function

    Public Overrides Function TryConvert(ByVal binder As System.Dynamic.ConvertBinder, ByRef result As Object) As Boolean
        ' Converting to string. 
        If binder.Type = GetType(String) Then
            result = dictionary("Textual")
            Return True
        End If

        ' Converting to integer.
        If binder.Type = GetType(Integer) Then
            result = dictionary("Numeric")
            Return True
        End If
        ' In case of any other type, the binder 
        ' attempts to perform the conversion itself.
        ' In most cases, a run-time exception is thrown.
        Return MyBase.TryConvert(binder, result)
    End Function
End Class

Sub Main()
    ' Creating the first dynamic number.
    Dim number As Object = New DynamicNumber()

    ' Creating properties and setting their values
    ' for the dynamic number.
    ' The TrySetMember method is called.
    number.Textual = "One"
    number.Numeric = 1


    ' Explicit conversion to string.
    Dim testString = CTypeDynamic(Of String)(number)
    Console.WriteLine(testString)

    ' Explicit conversion to integer.
    Dim testInteger = CTypeDynamic(number, GetType(Integer))
    Console.WriteLine(testInteger)

    ' The following statement produces a run-time exception
    ' because the conversion to double is not implemented.
    ' Dim testDouble = CTypeDynamic(Of Double)(number)

End Sub
' This example has the following output:

' One
' 1

Keterangan

Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan bagaimana konversi jenis harus dilakukan untuk objek dinamis. Ketika metode tidak ditimpa, pengikat run-time bahasa menentukan perilaku. (Dalam kebanyakan kasus, pengecualian run-time khusus bahasa dilemparkan.)

Dalam C#, jika metode ini ditimpa, metode ini secara otomatis dipanggil ketika Anda memiliki konversi eksplisit atau implisit, seperti yang ditunjukkan pada contoh kode di bawah ini.

Di Visual Basic, hanya konversi eksplisit yang didukung. Jika Anda mengambil alih metode ini, Anda memanggilnya dengan menggunakan CTypeDynamic fungsi atau CTypeDynamic .

// Explicit conversion.  
String sampleExplicit = (String)sampleObject;  
// Implicit conversion.  
String sampleImplicit = sampleObject;  

// Explicit conversion - first variant.  
Dim testExplicit1 = CTypeDynamic(Of String)(sampleObject)  
// Explicit conversion - second variant.  
Dim testExplicit2 = CTypeDynamic(sampleObject, GetType(String))