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

Definition

Namespace:

System.Dynamic

Assembly:

System.Linq.Expressions.dll

Quelle:

DynamicObject.cs

Stellt die Implementierung für Vorgänge bereit, die einen Member aufrufen. Von der DynamicObject-Klasse abgeleitete Klassen können diese Methode überschreiben, um dynamisches Verhalten für Vorgänge wie das Aufrufen einer Methode anzugeben.

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

Parameter

binder

InvokeMemberBinder

Stellt Informationen zum dynamischen Vorgang bereit. Die binder.Name -Eigenschaft stellt den Namen des Members bereit, auf dem der dynamische Vorgang ausgeführt wird. Beispielsweise gibt für die -Anweisung sampleObject.SampleMethod(100), wobei sampleObject ein instance der von der DynamicObject -Klasse abgeleiteten Klasse ist, binder.Name "SampleMethod" zurück. Die binder.IgnoreCase -Eigenschaft gibt an, ob beim Membernamen die Groß-/Kleinschreibung beachtet wird.

args

Object[]

Die Argumente, die während des Aufrufvorgangs an den Objektmember übergeben werden. Beispielsweise ist für die -Anweisung sampleObject.SampleMethod(100), wobei sampleObject von der DynamicObject -Klasse abgeleitet wird, args[0] gleich 100.

result

Object

Das Ergebnis des Memberaufrufs.

Gibt zurück

Boolean

true, wenn der Vorgang erfolgreich ist, andernfalls false. Wenn die Methode false zurückgibt, wird das Verhalten vom Laufzeitbinder der Sprache bestimmt. (In den meisten Fällen wird eine sprachspezifische Laufzeitausnahme ausgelöst.)

Beispiele

Angenommen, Sie möchten eine alternative Syntax für den Zugriff auf Werte in einem Wörterbuch bereitstellen, sodass Sie anstelle von sampleDictionary["Text"] = "Sample text" Schreiben (sampleDictionary("Text") = "Sample text" in Visual Basic) schreiben sampleDictionary.Text = "Sample text"können. Außerdem möchten Sie in der Lage sein, alle Standardwörterbuchmethoden für dieses Wörterbuch aufzurufen.

Im folgenden Codebeispiel wird die DynamicDictionary -Klasse veranschaulicht, die von der DynamicObject -Klasse abgeleitet wird. Die DynamicDictionary -Klasse enthält ein Objekt vom Dictionary<string, object> Typ (Dictionary(Of String, Object) in Visual Basic), um die Schlüssel-Wert-Paare zu speichern. Sie überschreibt die TryInvokeMember -Methode, um Methoden der Dictionary<TKey,TValue> -Klasse zu unterstützen, und setzt die TrySetMember Methoden und TryGetMember außer Kraft, um die neue Syntax zu unterstützen. Außerdem wird eine Print -Methode bereitgestellt, die alle Wörterbuchschlüssel und -werte ausgibt.

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

Hinweise

Von der DynamicObject -Klasse abgeleitete Klassen können diese Methode überschreiben, um anzugeben, wie Vorgänge, die einen Objektmember aufrufen, für ein dynamisches Objekt ausgeführt werden sollen. Wenn die Methode nicht überschrieben wird, bestimmt die Laufzeitbindung der Sprache das Verhalten. (In den meisten Fällen wird eine sprachspezifische Laufzeitausnahme ausgelöst.)

Wenn diese Methode überschrieben wird, wird sie automatisch aufgerufen, wenn Sie einen Vorgang wie sampleObject.SampleMethod(100)ausführen, wobei sampleObject von der DynamicObject -Klasse abgeleitet wird.

Sie können auch eigene Methoden zu Klassen hinzufügen, die von der DynamicObject -Klasse abgeleitet sind. Wenn Sie z. B. die TryInvokeMember -Methode überschreiben, versucht das dynamische Dispatchsystem zuerst zu bestimmen, ob die angegebene Methode in der -Klasse vorhanden ist. Wenn die -Methode nicht gefunden wird, wird die TryInvokeMember -Implementierung verwendet.

Diese Methode unterstützt ref keine Parameter und out . Alle Parameter im args Array werden nach Wert übergeben.