DynamicObject.TryUnaryOperation(UnaryOperationBinder, Object) Methode

Definition

Namespace:

System.Dynamic

Assembly:

System.Linq.Expressions.dll

Quelle:

DynamicObject.cs

Stellt die Implementierung für unäre Operationen bereit. Von der DynamicObject-Klasse abgeleitete Klassen können diese Methode überschreiben, um dynamisches Verhalten für Vorgänge wie Negation, Inkrement oder Dekrement anzugeben.

public:
 virtual bool TryUnaryOperation(System::Dynamic::UnaryOperationBinder ^ binder, [Runtime::InteropServices::Out] System::Object ^ % result);

public virtual bool TryUnaryOperation (System.Dynamic.UnaryOperationBinder binder, out object? result);

abstract member TryUnaryOperation : System.Dynamic.UnaryOperationBinder * obj -> bool
override this.TryUnaryOperation : System.Dynamic.UnaryOperationBinder * obj -> bool

Public Overridable Function TryUnaryOperation (binder As UnaryOperationBinder, ByRef result As Object) As Boolean

Parameter

binder

UnaryOperationBinder

Stellt Informationen zur unären Operation bereit. Die binder.Operation -Eigenschaft gibt ein ExpressionType -Objekt zurück. Für die -Anweisung, in der negativeNumber = -numbernumber von der DynamicObject -Klasse abgeleitet wird, binder.Operation wird beispielsweise "Negate" zurückgegeben.

result

Object

Das Ergebnis der unären Operation.

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 benötigen eine Datenstruktur, um textliche und numerische Darstellungen von Zahlen zu speichern, und Sie möchten einen mathematischen Negationsvorgang für solche Daten definieren.

Im folgenden Codebeispiel wird die DynamicNumber -Klasse veranschaulicht, die von der DynamicObject -Klasse abgeleitet ist. DynamicNumber überschreibt die TryUnaryOperation -Methode, um den Vorgang der mathematischen Negation zu aktivieren. Is überschreibt auch die TrySetMember Methoden und TryGetMember , um den Zugriff auf die Elemente zu ermöglichen.

In diesem Beispiel wird nur der mathematische Negationsvorgang unterstützt. Wenn Sie versuchen, eine Anweisung wie negativeNumber = +numberzu schreiben, tritt eine Laufzeitausnahme auf.

// Add using System.Linq.Expressions;
// to the beginning of the file

// The class derived from DynamicObject.
public class DynamicNumber : DynamicObject
{
    // The inner dictionary to store field names and values.
    Dictionary<string, object> dictionary
        = new Dictionary<string, object>();

    // Get the property value.
    public override bool TryGetMember(
        GetMemberBinder binder, out object result)
    {
        return dictionary.TryGetValue(binder.Name, out result);
    }

    // Set the property value.
    public override bool TrySetMember(
        SetMemberBinder binder, object value)
    {
        dictionary[binder.Name] = value;
        return true;
    }

    // Perform the unary operation.
    public override bool TryUnaryOperation(
        UnaryOperationBinder binder, out object result)
    {
        // The Textual property contains
        // the name of the unary operation in addition
        // to the textual representaion of the number.
        string resultTextual =
             binder.Operation + " " +
             dictionary["Textual"].ToString();
        int resultNumeric;

        // Determining what type of operation is being performed.
        switch (binder.Operation)
        {
            case ExpressionType.Negate:
                resultNumeric =
                     -(int)dictionary["Numeric"];
                break;
            default:
                // In case of any other unary operation,
                // print out the type of operation and return false,
                // which means that the language should determine
                // what to do.
                // (Usually the language just throws an exception.)
                Console.WriteLine(
                    binder.Operation +
                    ": This unary operation is not implemented");
                result = null;
                return false;
        }

        dynamic finalResult = new DynamicNumber();
        finalResult.Textual = resultTextual;
        finalResult.Numeric = resultNumeric;
        result = finalResult;
        return true;
    }
}

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;

        // Printing out properties. The TryGetMember method is called.
        Console.WriteLine(
            number.Textual + " " + number.Numeric);

        dynamic negativeNumber = new DynamicNumber();

        // Performing a mathematical negation.
        // TryUnaryOperation is called.
        negativeNumber = -number;

        Console.WriteLine(
            negativeNumber.Textual + " " + negativeNumber.Numeric);

        // The following statement produces a run-time exception
        // because the unary plus operation is not implemented.
        // negativeNumber = +number;
    }
}

// This code example produces the following output:

// One 1
// Negate One -1

' 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

    ' Perform the unary operation. 
    Public Overrides Function TryUnaryOperation(
        ByVal binder As System.Dynamic.UnaryOperationBinder,
        ByRef result As Object) As Boolean

        ' The Textual property contains the name of the unary operation
        ' in addition to the textual representaion of the number.
        Dim resultTextual As String =
        binder.Operation.ToString() & " " &
        dictionary("Textual")
        Dim resultNumeric As Integer

        ' Determining what type of operation is being performed.
        Select Case binder.Operation
            Case ExpressionType.Negate
                resultNumeric = -CInt(dictionary("Numeric"))
            Case Else
                ' In case of any other unary operation,
                ' print out the type of operation and return false,
                ' which means that the language should determine 
                ' what to do.
                ' (Usually the language just throws an exception.)            
                Console.WriteLine(
                    binder.Operation.ToString() &
                    ": This unary operation is not implemented")
                result = Nothing
                Return False
        End Select

        Dim finalResult As Object = New DynamicNumber()
        finalResult.Textual = resultTextual
        finalResult.Numeric = resultNumeric
        result = finalResult
        Return True
    End Function
End Class

Sub Test()
    ' 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

    ' Printing out properties. The TryGetMember method is called.
    Console.WriteLine(
        number.Textual & " " & number.Numeric)

    Dim negativeNumber As Object = New DynamicNumber()

    ' Performing a mathematical negation.
    ' The TryUnaryOperation is called.
    negativeNumber = -number

    Console.WriteLine(
        negativeNumber.Textual & " " & negativeNumber.Numeric)

    ' The following statement produces a run-time exception
    ' because the unary plus operation is not implemented.
    'negativeNumber = +number
End Sub

' This code example produces the following output:

' One 1
' Negate One -1

Hinweise

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

Diese Methode wird aufgerufen, wenn Sie über unäre Vorgänge wie Negation, Inkrement oder Dekrement verfügen. Wenn die TryUnaryOperation Methode beispielsweise überschrieben wird, wird diese Methode automatisch für Anweisungen wie negativeNumber = -numberaufgerufen, wobei number von der DynamicObject -Klasse abgeleitet wird.

Sie können Informationen zum Typ des unären Vorgangs abrufen, indem Sie die Operation -Eigenschaft des binder Parameters verwenden.

Wenn Ihr dynamisches Objekt nur in C# und Visual Basic verwendet wird, kann die binder.Operation -Eigenschaft einen der folgenden Werte aus der ExpressionType Enumeration aufweisen. In anderen Sprachen wie IronPython oder IronRuby können Sie jedoch andere Werte haben.

Wert	BESCHREIBUNG	C#	Visual Basic
Decrement	Ein unärer Dekrementvorgang.	a--	Wird nicht unterstützt.
Increment	Ein unärer Inkrementvorgang.	a++	Wird nicht unterstützt.
Negate	Eine arithmetische Negation.	-a	-a
Not	Eine logische Negation.	!a	Not a
OnesComplement	Eine ergänzung.	~a	Wird nicht unterstützt.
IsFalse	Ein falscher Bedingungswert.	a && b	Wird nicht unterstützt.
IsTrue	Ein wahrer Bedingungswert.	a || b	Wird nicht unterstützt.
UnaryPlus	Ein unärer Pluspunkt.	+a	+a

Hinweis

Um Vorgänge (a || b) und AndAlso (a && b) für dynamische Objekte in C# zu implementieren OrElse , sollten Sie sowohl die TryUnaryOperation -Methode als auch die TryBinaryOperation -Methode implementieren.

Der OrElse Vorgang besteht aus dem unären IsTrue Vorgang und dem binären Or Vorgang. Der Or Vorgang wird nur ausgeführt, wenn das Ergebnis des IsTrue Vorgangs ist false.

Der AndAlso Vorgang besteht aus dem unären IsFalse Vorgang und dem binären And Vorgang. Der And Vorgang wird nur ausgeführt, wenn das Ergebnis des IsFalse Vorgangs ist false.