DynamicObject.TryConvert(ConvertBinder, Object) Metoda

Definice

Obor názvů:

System.Dynamic

Sestavení:

System.Linq.Expressions.dll

Zdroj:

DynamicObject.cs

Poskytuje implementaci pro operace převodu typů. Třídy odvozené z DynamicObject třídy mohou přepsat tuto metodu a určit dynamické chování pro operace, které převádějí objekt z jednoho typu na jiný.

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

Parametry

binder

ConvertBinder

Poskytuje informace o operaci převodu. Vlastnost binder.Type poskytuje typ, na který musí být objekt převeden. Například pro příkaz (String)sampleObject v jazyce C# (CType(sampleObject, Type) v jazyce Visual Basic), kde sampleObject je instance třídy odvozená z DynamicObject třídy , binder.Type vrátí String typ . Vlastnost binder.Explicit poskytuje informace o druhu převodu, ke kterému dochází. Vrátí se true pro explicitní převod a false pro implicitní převod.

result

Object

Výsledek operace převodu typů.

Návraty

Boolean

truepokud je operace úspěšná; v opačném případě . false Pokud tato metoda vrátí false, pořadač běhu jazyka určuje chování. (Ve většině případů se vyvolá výjimka za běhu pro konkrétní jazyk.)

Příklady

Předpokládejme, že potřebujete datovou strukturu pro ukládání textových a číselných reprezentací čísel a chcete definovat převody této datové struktury na řetězce a celá čísla.

Následující příklad kódu ukazuje DynamicNumber třídu, která je odvozena z DynamicObject třídy . DynamicNumber přepíše metodu TryConvert pro povolení převodu typu. Přepíše TrySetMember také metody a TryGetMember pro povolení přístupu k datovým prvkům.

V tomto příkladu je podporován pouze převod na řetězce a celá čísla. Pokud se pokusíte převést objekt na jiný typ, vyvolá se výjimka za běhu.

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

Poznámky

Třídy odvozené z DynamicObject třídy mohou přepsat tuto metodu a určit, jak má být proveden převod typu pro dynamický objekt. Pokud metoda není přepsána, pořadač za běhu jazyka určuje chování. (Ve většině případů se vyvolá výjimka za běhu pro konkrétní jazyk.)

Pokud je tato metoda v jazyce C# přepsána, je automaticky vyvolána při explicitním nebo implicitním převodu, jak je znázorněno v příkladu kódu níže.

V jazyce Visual Basic je podporován pouze explicitní převod. Pokud tuto metodu přepíšete, zavoláte ji pomocí CTypeDynamic funkcí nebo 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))