DynamicObject.TryInvokeMember(InvokeMemberBinder, Object[], Object) Método

Definição

Fornece a implementação para operações que invocam um membro. Classes derivadas da DynamicObject classe podem substituir esse método para especificar o comportamento dinâmico para operações como chamar um método.

public:
 virtual bool TryInvokeMember(System::Dynamic::InvokeMemberBinder ^ binder, cli::array <System::Object ^> ^ args, [Runtime::InteropServices::Out] System::Object ^ % result);
public virtual bool TryInvokeMember(System.Dynamic.InvokeMemberBinder binder, object[] args, out object result);
abstract member TryInvokeMember : System.Dynamic.InvokeMemberBinder * obj[] * obj -> bool
override this.TryInvokeMember : System.Dynamic.InvokeMemberBinder * obj[] * obj -> bool
Public Overridable Function TryInvokeMember (binder As InvokeMemberBinder, args As Object(), ByRef result As Object) As Boolean

Parâmetros

binder
InvokeMemberBinder

Fornece informações sobre a operação dinâmica. A binder.Name propriedade fornece o nome do membro no qual a operação dinâmica é executada. Por exemplo, para a instrução sampleObject.SampleMethod(100), onde sampleObject está uma instância da classe derivada da DynamicObject classe, binder.Name retorna "SampleMethod". A binder.IgnoreCase propriedade especifica se o nome do membro diferencia maiúsculas de minúsculas.

args
Object[]

Os argumentos que são passados para o membro do objeto durante a operação de invocação. Por exemplo, para a instrução sampleObject.SampleMethod(100), onde sampleObject é derivada da DynamicObject classe, args[0] é igual a 100.

result
Object

O resultado da invocação de membro.

Retornos

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 do idioma determinará o comportamento. (Na maioria dos casos, uma exceção de tempo de execução específica do idioma é gerada.)

Exemplos

Suponha que você queira fornecer sintaxe alternativa para acessar valores em um dicionário, para que, em vez de escrever sampleDictionary["Text"] = "Sample text" (sampleDictionary("Text") = "Sample text" em Visual Basic), você possa escrever sampleDictionary.Text = "Sample text". Além disso, você deseja poder chamar todos os métodos de dicionário padrão neste dicionário.

O exemplo de código a seguir demonstra a DynamicDictionary classe, que é derivada da DynamicObject classe. A classe DynamicDictionary contém um objeto do tipo Dictionary<string, object> (Dictionary(Of String, Object) em Visual Basic) para armazenar os pares chave-valor. Ele substitui o TryInvokeMember método para dar suporte aos métodos da Dictionary<TKey,TValue> classe e substitui os TrySetMember métodos e TryGetMember para dar suporte à nova sintaxe. Ele também fornece um Print método, que imprime todas as chaves e valores do dicionário.

// Add using System.Reflection;
// to the beginning of the file.

// The class derived from DynamicObject.
public class DynamicDictionary : 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;
    }

    // Calling a method.
    public override bool TryInvokeMember(
        InvokeMemberBinder binder, object[] args, out object result)
    {
        Type dictType = typeof(Dictionary<string, object>);
        try
        {
            result = dictType.InvokeMember(
                         binder.Name,
                         BindingFlags.InvokeMethod,
                         null, dictionary, args);
            return true;
        }
        catch
        {
            result = null;
            return false;
        }
    }

    // This methods prints out dictionary elements.
    public void Print()
    {
        foreach (var pair in dictionary)
            Console.WriteLine(pair.Key + " " + pair.Value);
        if (dictionary.Count == 0)
            Console.WriteLine("No elements in the dictionary.");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Creating a dynamic dictionary.
        dynamic person = new DynamicDictionary();

        // Adding new dynamic properties.
        // The TrySetMember method is called.
        person.FirstName = "Ellen";
        person.LastName = "Adams";

        // Calling a method defined in the DynmaicDictionary class.
        // The Print method is called.
        person.Print();

        Console.WriteLine(
            "Removing all the elements from the dictionary.");

        // Calling a method that is not defined in the DynamicDictionary class.
        // The TryInvokeMember method is called.
        person.Clear();

        // Calling the Print method again.
        person.Print();

        // The following statement throws an exception at run time.
        // There is no Sample method
        // in the dictionary or in the DynamicDictionary class.
        // person.Sample();
    }
}

// This example has the following output:

// FirstName Ellen
// LastName Adams
// Removing all the elements from the dictionary.
// No elements in the dictionary.
' Add Imports System.Reflection
' to the beginning of the file.

' The class derived from DynamicObject.
Public Class DynamicDictionary
    Inherits DynamicObject

    ' The inner dictionary.
    Dim dictionary As New Dictionary(Of String, Object)

    ' Getting a 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

    ' Setting a 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


    ' Calling a method.
    Public Overrides Function TryInvokeMember(
        ByVal binder As System.Dynamic.InvokeMemberBinder,
        ByVal args() As Object, ByRef result As Object) As Boolean

        Dim dictType As Type = GetType(Dictionary(Of String, Object))
        Try
            result = dictType.InvokeMember(
                         binder.Name,
                         BindingFlags.InvokeMethod,
                         Nothing, dictionary, args)
            Return True
        Catch ex As Exception
            result = Nothing
            Return False
        End Try
    End Function

    ' This method prints out dictionary elements.
    Public Sub Print()
        For Each pair In dictionary
            Console.WriteLine(pair.Key & " " & pair.Value)
        Next
        If (dictionary.Count = 0) Then
            Console.WriteLine("No elements in the dictionary.")
        End If
    End Sub
End Class

Sub Test()
    ' Creating a dynamic dictionary.
    Dim person As Object = New DynamicDictionary()

    ' Adding new dynamic properties.
    ' The TrySetMember method is called.
    person.FirstName = "Ellen"
    person.LastName = "Adams"

    ' Calling a method defined in the DynmaicDictionary class.
    ' The Print method is called.
    person.Print()

    Console.WriteLine(
        "Removing all the elements from the dictionary.")

    ' Calling a method that is not defined in the DynamicDictionary class.
    ' The TryInvokeMember method is called.
    person.Clear()

    ' Calling the Print method again.
    person.Print()

    ' The following statement throws an exception at run time.
    ' There is no Sample method 
    ' in the dictionary or in the DynamicDictionary class.
    ' person.Sample()
End Sub


' This example has the following output:

' FirstName Ellen 
' LastName Adams
' Removing all the elements from the dictionary.
' No elements in the dictionary.

Comentários

Classes derivadas da DynamicObject classe podem substituir esse método para especificar como as operações que invocam um membro do objeto devem ser executadas 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 do idioma é gerada.)

Se esse método for substituído, ele será invocado automaticamente quando você executar uma operação como sampleObject.SampleMethod(100), onde sampleObject é derivada da DynamicObject classe.

Você também pode adicionar seus próprios métodos a classes derivadas da DynamicObject classe. Por exemplo, se você substituir o TryInvokeMember método, o sistema de expedição dinâmica primeiro tentará determinar se o método especificado existe na classe. Se ele não encontrar o método, ele usará a TryInvokeMember implementação.

Esse método não dá suporte ref e out parâmetros. Todos os parâmetros na args matriz são passados por valor.

Aplica-se a