DynamicObject.TryConvert(ConvertBinder, Object) Methode

Definitie

Biedt implementatie voor typeconversiebewerkingen. Klassen die zijn afgeleid van de DynamicObject klasse kunnen deze methode overschrijven om dynamisch gedrag op te geven voor bewerkingen die een object van het ene type naar het andere converteren.

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

Parameters

binder
ConvertBinder

Bevat informatie over de conversiebewerking. De binder.Type eigenschap biedt het type waarnaar het object moet worden geconverteerd. Voor de instructie (String)sampleObject in C# (CType(sampleObject, Type) in Visual Basic), waarbij sampleObject een exemplaar is van de klasse die is afgeleid van de klasse DynamicObject, retourneert binder.Type het type String. De binder.Explicit eigenschap bevat informatie over het type conversie dat plaatsvindt. Het retourneert true voor expliciete conversie en false voor impliciete conversie.

result
Object

Het resultaat van de typeconversiebewerking.

Retouren

true als de bewerking is geslaagd; anders, false. Als deze methode wordt geretourneerd false, bepaalt de runtimebinding van de taal het gedrag. (In de meeste gevallen wordt er een taalspecifieke runtime-uitzondering gegenereerd.)

Voorbeelden

Stel dat u een gegevensstructuur nodig hebt om tekstuele en numerieke weergaven van getallen op te slaan en dat u conversies van deze gegevensstructuur wilt definiƫren naar tekenreeksen en gehele getallen.

In het volgende codevoorbeeld ziet u de DynamicNumber klasse, die is afgeleid van de DynamicObject klasse. DynamicNumber overschrijft de TryConvert methode om typeconversie in te schakelen. Het overschrijft ook de TrySetMember en TryGetMember methoden om toegang tot de gegevenselementen mogelijk te maken.

In dit voorbeeld wordt alleen conversie naar tekenreeksen en gehele getallen ondersteund. Als u een object probeert te converteren naar een ander type, wordt er een runtime-uitzondering gegenereerd.

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

Opmerkingen

Klassen die zijn afgeleid van de DynamicObject klasse kunnen deze methode overschrijven om op te geven hoe een typeconversie moet worden uitgevoerd voor een dynamisch object. Wanneer de methode niet wordt overschreven, bepaalt de runtimebinding van de taal het gedrag. (In de meeste gevallen wordt er een taalspecifieke runtime-uitzondering gegenereerd.)

Als deze methode in C# wordt overschreven, wordt deze automatisch aangeroepen wanneer u een expliciete of impliciete conversie hebt, zoals wordt weergegeven in het onderstaande codevoorbeeld.

In Visual Basic wordt alleen expliciete conversie ondersteund. Als u deze methode overschrijft, roept u deze aan met behulp van de CTypeDynamic of CTypeDynamic functies.

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

Van toepassing op