DynamicObject.TryConvert(ConvertBinder, Object) Yöntem

Tanım

Ad Alanı:

System.Dynamic

Bütünleştirilmiş Kod:

System.Linq.Expressions.dll

Kaynak:

DynamicObject.cs

Tür dönüştürme işlemleri için uygulama sağlar. sınıfından DynamicObject türetilen sınıflar, bir nesneyi bir türden diğerine dönüştüren işlemler için dinamik davranış belirtmek üzere bu yöntemi geçersiz kılabilir.

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

Parametreler

binder

ConvertBinder

Dönüştürme işlemi hakkında bilgi sağlar. özelliği, binder.Type nesnenin dönüştürülmesi gereken türü sağlar. Örneğin, sınıfından türetilen sınıfın bir örneği olan sampleObject C# (CType(sampleObject, Type)Visual Basic'te) deyimi (String)sampleObject için türü döndürürString.DynamicObjectbinder.Type özelliği, binder.Explicit gerçekleşen dönüştürme türü hakkında bilgi sağlar. Açık dönüştürme ve false örtük dönüştürme için döndürürtrue.

result

Object

Tür dönüştürme işleminin sonucu.

Döndürülenler

Boolean

true işlem başarılı olursa; aksi takdirde , false. Bu yöntem döndürürse false, davranışı dilin çalışma zamanı bağlayıcısı belirler. (Çoğu durumda, dile özgü bir çalışma zamanı özel durumu oluşturulur.)

Örnekler

Sayıların metinsel ve sayısal gösterimlerini depolamak için bir veri yapısına ihtiyacınız olduğunu ve bu veri yapısının dizelere ve tamsayılara dönüşümlerini tanımlamak istediğinizi varsayalım.

Aşağıdaki kod örneği, sınıfından DynamicNumber türetilen sınıfını DynamicObject gösterir. DynamicNumber türü dönüştürmeyi TryConvert etkinleştirmek için yöntemini geçersiz kılar. Ayrıca veri öğelerine TrySetMember erişimi etkinleştirmek için ve TryGetMember yöntemlerini geçersiz kılar.

Bu örnekte yalnızca dizelere ve tamsayılara dönüştürme desteklenir. Bir nesneyi başka bir türe dönüştürmeye çalışırsanız, çalışma zamanı özel durumu oluşturulur.

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

Açıklamalar

sınıfından DynamicObject türetilen sınıflar, dinamik nesne için tür dönüştürmenin nasıl gerçekleştirileceğini belirtmek için bu yöntemi geçersiz kılabilir. Yöntemi geçersiz kılınmadığında, davranışı dilin çalışma zamanı bağlayıcısı belirler. (Çoğu durumda, dile özgü bir çalışma zamanı özel durumu oluşturulur.)

C# dilinde, bu yöntem geçersiz kılınırsa, aşağıdaki kod örneğinde gösterildiği gibi açık veya örtük bir dönüştürmeniz olduğunda otomatik olarak çağrılır.

Visual Basic'te yalnızca açık dönüştürme desteklenir. Bu yöntemi geçersiz kılarsanız, veya CTypeDynamic işlevlerini kullanarak CTypeDynamic çağırırsınız.

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