DynamicObject.TryInvokeMember(InvokeMemberBinder, Object[], Object) Metoda

Definicja

Przestrzeń nazw:

System.Dynamic

Zestaw:

System.Linq.Expressions.dll

Źródło:

DynamicObject.cs

Zapewnia implementację operacji, które wywołują element członkowski. Klasy pochodzące z DynamicObject klasy mogą zastąpić tę metodę w celu określenia dynamicznego zachowania operacji, takich jak wywoływanie metody.

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

Parametry

binder

InvokeMemberBinder

Zawiera informacje o operacji dynamicznej. Właściwość binder.Name zawiera nazwę elementu członkowskiego, na którym jest wykonywana operacja dynamiczna. Na przykład dla instrukcji sampleObject.SampleMethod(100), gdzie sampleObject jest wystąpieniem klasy pochodnej DynamicObject z klasy, binder.Name zwraca wartość "SampleMethod". Właściwość binder.IgnoreCase określa, czy w nazwie elementu członkowskiego jest uwzględniana wielkość liter.

args

Object[]

Argumenty przekazywane do elementu członkowskiego obiektu podczas operacji wywołania. Na przykład dla instrukcji sampleObject.SampleMethod(100), gdzie sampleObject pochodzi z DynamicObject klasy, args[0] jest równa 100.

result

Object

Wynik wywołania elementu członkowskiego.

Zwraca

Boolean

true jeśli operacja zakończy się pomyślnie; w przeciwnym razie , false. Jeśli ta metoda zwróci falsewartość , powiązanie w czasie wykonywania języka określa zachowanie. (W większości przypadków zgłaszany jest wyjątek czasu wykonywania specyficzny dla języka).

Przykłady

Załóżmy, że chcesz podać alternatywną składnię uzyskiwania dostępu do wartości w słowniku, aby zamiast pisać sampleDictionary["Text"] = "Sample text" (sampleDictionary("Text") = "Sample text"w Języku Visual Basic), możesz napisać .sampleDictionary.Text = "Sample text" Ponadto chcesz mieć możliwość wywołania wszystkich standardowych metod słownika w tym słowniku.

W poniższym przykładzie kodu pokazano klasę DynamicDictionary , która pochodzi z DynamicObject klasy . Klasa DynamicDictionary zawiera obiekt Dictionary<string, object> typu (Dictionary(Of String, Object) w Visual Basic) do przechowywania par klucz-wartość. Zastępuje metodę TryInvokeMember do obsługi metod Dictionary<TKey,TValue> klasy i zastępuje TrySetMember metody i TryGetMember do obsługi nowej składni. Udostępnia również metodę Print , która wyświetla wszystkie klucze i wartości słownika.

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

Uwagi

Klasy pochodzące z DynamicObject klasy mogą zastąpić tę metodę, aby określić sposób wykonywania operacji wywołujących element członkowski obiektu dla obiektu dynamicznego. Jeśli metoda nie zostanie zastąpiona, powiązanie czasu wykonywania języka określa zachowanie. (W większości przypadków zgłaszany jest wyjątek czasu wykonywania specyficzny dla języka).

Jeśli ta metoda jest zastępowana, jest ona wywoływana automatycznie podczas wykonywania operacji, takiej jak sampleObject.SampleMethod(100), gdzie sampleObject pochodzi z DynamicObject klasy .

Możesz również dodać własne metody do klas, które pochodzą z DynamicObject klasy . Jeśli na przykład zastąpisz metodę TryInvokeMember , dynamiczny system wysyłania najpierw próbuje ustalić, czy określona metoda istnieje w klasie. Jeśli metoda nie zostanie odnaleziona, zostanie użyta implementacja TryInvokeMember .

Ta metoda nie obsługuje ref parametrów i out . Wszystkie parametry w tablicy args są przekazywane przez wartość.