DynamicObject.TryConvert(ConvertBinder, Object) Metódus

Definíció

Névtér:

System.Dynamic

Szerelvények:

netstandard.dll, System.Linq.Expressions.dll

Forrás:

DynamicObject.cs

Implementációt biztosít a típuskonvertálási műveletekhez. Az osztályból származó osztályok felülbírálhatják ezt a DynamicObject metódust az objektumok egyik típusból a másikba konvertáló műveletek dinamikus viselkedésének meghatározásához.

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

Paraméterek

binder

ConvertBinder

A konvertálási művelettel kapcsolatos információkat nyújt. A binder.Type tulajdonság azt a típust adja meg, amelyre az objektumot konvertálni kell. Például a C# (String)sampleObject utasításhoz (CType(sampleObject, Type) Visual Basic), ahol a sampleObject a DynamicObject osztályból származó osztály egy példánya, binder.Type a String típust adja vissza. A binder.Explicit tulajdonság információt nyújt az átalakítás típusáról. Explicit konverzióra és true implicit konverzióra ad visszafalse.

result

Object

A típuskonvertálási művelet eredménye.

Válaszok

Boolean

trueha a művelet sikeres; egyéb esetben. false Ha ez a metódus visszatér false, a nyelv futásidejű kötése határozza meg a viselkedést. (A legtöbb esetben a rendszer nyelvspecifikus futásidejű kivételt ad ki.)

Példák

Tegyük fel, hogy szüksége van egy adatstruktúrára a számok szöveges és numerikus ábrázolásának tárolásához, és sztringekre és egész számokra szeretné definiálni az adatszerkezet átalakítását.

Az alábbi példakód az DynamicNumber osztályból DynamicObject származtatott osztályt mutatja be. DynamicNumber felülbírálja a TryConvert típuskonverzió engedélyezésének módját. Felülbírálja az TrySetMember adatelemekhez való hozzáférést engedélyező módszereket és TryGetMember módszereket is.

Ebben a példában csak sztringek és egész számok konvertálása támogatott. Ha bármilyen más típusú objektumot próbál átalakítani, a rendszer futásidejű kivételt okoz.

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

Megjegyzések

Az osztályból származó osztályok felülbírálhatják ezt a DynamicObject metódust, hogy megadják, hogyan kell típusátalakítást végrehajtani egy dinamikus objektumon. Ha a metódus nincs felülírva, a nyelv futásidejű kötése határozza meg a viselkedést. (A legtöbb esetben a rendszer nyelvspecifikus futásidejű kivételt ad ki.)

A C#-ban, ha ez a módszer felül van bírálva, a rendszer automatikusan meghívja azt explicit vagy implicit konverzió esetén, ahogyan az alábbi kód példában látható.

A Visual Basic csak a explicit átalakítás támogatott. Ha felülbírálja ezt a metódust, a függvények vagy CTypeDynamic függvények CTypeDynamic használatával hívja meg.

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