DynamicObject.TryConvert(ConvertBinder, Object) Método

Definição

Namespace:

System.Dynamic

Assembly:

System.Linq.Expressions.dll

Origem:

DynamicObject.cs

Fornece implementação para operações de conversão de tipo. As classes derivadas da classe DynamicObject podem substituir este método para especificar o comportamento dinâmico para operações que convertem um objeto de um tipo em outro.

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

Parâmetros

binder

ConvertBinder

Fornece informações sobre a operação de conversão. A propriedade binder.Type fornece o tipo para o qual o objeto deve ser convertido. Por exemplo, para a instrução (String)sampleObject no C# (CType(sampleObject, Type) no Visual Basic), em que sampleObject é uma instância da classe que deriva da classe DynamicObject, binder.Type retorna o tipo String. A propriedade binder.Explicit fornece informações sobre o tipo de conversão que ocorre. Ela retorna true para conversão explícita e false para conversão implícita.

result

Object

O resultado da operação de conversão de tipo.

Retornos

Boolean

true se a operação for bem-sucedida; caso contrário, false. Se esse método retornar false, o associador de tempo de execução da linguagem determinará o comportamento. (Na maioria dos casos, uma exceção de tempo de execução específica a um idioma é gerada.)

Exemplos

Suponha que você precise de uma estrutura de dados para armazenar representações textuais e numéricas de números e defina conversões dessa estrutura de dados em cadeias de caracteres e inteiros.

O exemplo de código a seguir demonstra a DynamicNumber classe , que é derivada da DynamicObject classe . DynamicNumber substitui o TryConvert método para habilitar a conversão de tipo. Ele também substitui os TrySetMember métodos e TryGetMember para habilitar o acesso aos elementos de dados.

Neste exemplo, há suporte apenas para conversão em cadeias de caracteres e inteiros. Se você tentar converter um objeto em qualquer outro tipo, uma exceção em tempo de execução será gerada.

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

Comentários

Classes derivadas da DynamicObject classe podem substituir esse método para especificar como uma conversão de tipo deve ser executada para um objeto dinâmico. Quando o método não é substituído, o associador de tempo de execução do idioma determina o comportamento. (Na maioria dos casos, uma exceção de tempo de execução específica a um idioma é gerada.)

Em C#, se esse método for substituído, ele será invocado automaticamente quando você tiver uma conversão explícita ou implícita, conforme mostrado no exemplo de código abaixo.

No Visual Basic, há suporte apenas para conversão explícita. Se você substituir esse método, chame-o usando as CTypeDynamic funções ou 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))