DynamicObject.TryBinaryOperation Methode

Definition

Stellt eine Implementierung für binäre Vorgänge bereit. Von der DynamicObject Klasse abgeleitete Klassen können diese Methode überschreiben, um dynamisches Verhalten für Vorgänge wie Addition und Multiplikation anzugeben.

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

Parameter

binder
BinaryOperationBinder

Stellt Informationen zum binären Vorgang bereit. Die binder.Operation -Eigenschaft gibt ein ExpressionType -Objekt zurück. Gibt z. B. für die sum = first + second Anweisung, wo first und second von der DynamicObject Klasse abgeleitet werden, binder.Operation die ExpressionType.AddRückgabe zurück.

arg
Object

Der rechte Operand für den binären Vorgang. Beispielsweise ist für die sum = first + second Anweisung, wo first und second von der DynamicObject Klasse abgeleitet wird, arg gleich second.

result
Object

Das Ergebnis des binären Vorgangs.

Gibt zurück

true, wenn der Vorgang erfolgreich ist, andernfalls false. Wenn diese Methode zurückgegeben wird false, bestimmt der Laufzeitordner der Sprache das Verhalten. (In den meisten Fällen wird eine sprachspezifische Laufzeit ausnahme ausgelöst.)

Beispiele

Angenommen, Sie benötigen eine Datenstruktur, um Text- und numerische Darstellungen von Zahlen zu speichern, und Sie möchten grundlegende mathematische Vorgänge wie Addition und Subtraktion für solche Daten definieren.

Im folgenden Codebeispiel wird die DynamicNumber Klasse veranschaulicht, die von der DynamicObject Klasse abgeleitet wird. DynamicNumber setzt die TryBinaryOperation Methode außer Kraft, um mathematische Vorgänge zu aktivieren. Außerdem werden die TrySetMember Und TryGetMember Methoden außer Kraft gesetzt, um den Zugriff auf die Elemente zu ermöglichen.

In diesem Beispiel werden nur Additions- und Subtraktionsvorgänge unterstützt. Wenn Sie versuchen, eine Anweisung wie resultNumber = firstNumber*secondNumbereine Laufzeitausnahme zu schreiben, wird eine Laufzeitausnahme ausgelöst.

// 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 binary operation.
    public override bool TryBinaryOperation(
        BinaryOperationBinder binder, object arg, out object result)
    {
        // The Textual property contains the textual representaion
        // of two numbers, in addition to the name
        // of the binary operation.
        string resultTextual =
            dictionary["Textual"].ToString() + " "
            + binder.Operation + " " +
            ((DynamicNumber)arg).dictionary["Textual"].ToString();

        int resultNumeric;

        // Checking what type of operation is being performed.
        switch (binder.Operation)
        {
            // Proccessing mathematical addition (a + b).
            case ExpressionType.Add:
                resultNumeric =
                    (int)dictionary["Numeric"] +
                    (int)((DynamicNumber)arg).dictionary["Numeric"];
                break;

            // Processing mathematical substraction (a - b).
            case ExpressionType.Subtract:
                resultNumeric =
                    (int)dictionary["Numeric"] -
                    (int)((DynamicNumber)arg).dictionary["Numeric"];
                break;

            // In case of any other binary 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.)
            default:
                Console.WriteLine(
                    binder.Operation +
                    ": This binary 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 firstNumber = new DynamicNumber();

        // Creating properties and setting their values
        // for the first dynamic number.
        // The TrySetMember method is called.
        firstNumber.Textual = "One";
        firstNumber.Numeric = 1;

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

        // Creating the second dynamic number.
        dynamic secondNumber = new DynamicNumber();
        secondNumber.Textual = "Two";
        secondNumber.Numeric = 2;
        Console.WriteLine(
            secondNumber.Textual + " " + secondNumber.Numeric);

        dynamic resultNumber = new DynamicNumber();

        // Adding two numbers. The TryBinaryOperation is called.
        resultNumber = firstNumber + secondNumber;

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

        // Subtracting two numbers. TryBinaryOperation is called.
        resultNumber = firstNumber - secondNumber;

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

        // The following statement produces a run-time exception
        // because the multiplication operation is not implemented.
        // resultNumber = firstNumber * secondNumber;
    }
}

// This code example produces the following output:

// One 1
// Two 2
// One Add Two 3
// One Subtract Two -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 binary operation. 
    Public Overrides Function TryBinaryOperation(
        ByVal binder As System.Dynamic.BinaryOperationBinder,
        ByVal arg As Object, ByRef result As Object) As Boolean

        ' The Textual property contains the textual representaion 
        ' of two numbers, in addition to the name of the binary operation.
        Dim resultTextual As String =
            dictionary("Textual") & " " &
            binder.Operation.ToString() & " " &
        CType(arg, DynamicNumber).dictionary("Textual")

        Dim resultNumeric As Integer

        ' Checking what type of operation is being performed.
        Select Case binder.Operation
            ' Proccessing mathematical addition (a + b).
            Case ExpressionType.Add
                resultNumeric =
                CInt(dictionary("Numeric")) +
                CInt((CType(arg, DynamicNumber)).dictionary("Numeric"))

                ' Processing mathematical substraction (a - b).
            Case ExpressionType.Subtract
                resultNumeric =
                CInt(dictionary("Numeric")) -
                CInt((CType(arg, DynamicNumber)).dictionary("Numeric"))

            Case Else
                ' In case of any other binary 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 binary 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 firstNumber As Object = New DynamicNumber()

    ' Creating properties and setting their values
    ' for the first dynamic number. 
    ' The TrySetMember method is called.
    firstNumber.Textual = "One"
    firstNumber.Numeric = 1

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

    ' Creating the second dynamic number.
    Dim secondNumber As Object = New DynamicNumber()
    secondNumber.Textual = "Two"
    secondNumber.Numeric = 2
    Console.WriteLine(
        secondNumber.Textual & " " & secondNumber.Numeric)

    Dim resultNumber As Object = New DynamicNumber()

    ' Adding two numbers. TryBinaryOperation is called.
    resultNumber = firstNumber + secondNumber
    Console.WriteLine(
        resultNumber.Textual & " " & resultNumber.Numeric)

    ' Subtracting two numbers. TryBinaryOperation is called.
    resultNumber = firstNumber - secondNumber
    Console.WriteLine(
        resultNumber.Textual & " " & resultNumber.Numeric)

    ' The following statement produces a run-time exception
    ' because the multiplication operation is not implemented.
    ' resultNumber = firstNumber * secondNumber
End Sub

' This code example produces the following output:

' One 1
' Two 2
' One Add Two 3
' One Subtract Two -1

Hinweise

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

Diese Methode wird aufgerufen, wenn Sie binäre Vorgänge wie Addition oder Multiplikation haben. Wenn die TryBinaryOperation Methode beispielsweise überschrieben wird, wird sie automatisch für Anweisungen wie sum = first + second oder multiply = first*second, wo first von der DynamicObject Klasse abgeleitet wird, aufgerufen.

Mithilfe der Eigenschaft des binder Parameters können Sie Informationen über den Typ des binären Vorgangs Operation abrufen.

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
Add Ein Additionsvorgang ohne Überlaufüberprüfung für numerische Operanden. a + b a + b
AddAssign Ein additionsverbundener Zuordnungsvorgang ohne Überlaufüberprüfung für numerische Operanden. a += b Wird nicht unterstützt.
And Ein bitweiser AND Vorgang. a & b a And b
AndAssign Ein bitweiser AND Verbundzuordnungsvorgang. a &= b Wird nicht unterstützt.
Divide Ein arithmetischer Divisionsvorgang. a / b a / b
DivideAssign Eine arithmetische Division zusammengesetzte Zuordnungsoperation. a /= b Wird nicht unterstützt.
ExclusiveOr Ein bitweiser XOR Vorgang. a ^ b a Xor b
ExclusiveOrAssign Ein bitweiser XOR Verbundzuordnungsvorgang. a ^= b Wird nicht unterstützt.
GreaterThan Ein "größer als"-Vergleich. a > b a > b
GreaterThanOrEqual Ein "größer als oder gleich" Vergleich. a >= b Wird nicht unterstützt.
LeftShift Ein bitweiser Linksverschiebungsvorgang. a << b a << b
LeftShiftAssign Ein bitweiser Zuordnungsvorgang für die linke Schicht. a <<= b Wird nicht unterstützt.
LessThan Ein "kleiner als"-Vergleich. a < b a < b
LessThanOrEqual Ein Vergleich von "kleiner als oder gleich" a <= b Wird nicht unterstützt.
Modulo Eine arithmetische Restoperation. a % b a Mod b
ModuloAssign Eine arithmetische Restzuordnungsoperation. a %= b Wird nicht unterstützt.
Multiply Ein Multiplikationsvorgang ohne Überlaufüberprüfung für numerische Operanden. a * b a * b
MultiplyAssign Ein Multiplikationszuordnungsvorgang ohne Überlaufüberprüfung für numerische Operanden. a *= b Wird nicht unterstützt.
NotEqual Ein Ungleichheitsvergleich. a != b a <> b
Or Ein bitweiser oder logischer OR Vorgang. a &#124; b a Or b
OrAssign Eine bitweise oder logische OR Verbundzuordnung. a &#124;= b Wird nicht unterstützt.
Power Ein mathematischer Vorgang, der eine Zahl auf eine Potenz anhebt. Wird nicht unterstützt. a ^ b
RightShift Ein bitweiser Rechtsverschiebungsvorgang. a >> b a >> b
RightShiftAssign Ein bitweiser Zuweisungsvorgang nach rechts nach rechts. a >>= b Wird nicht unterstützt.
Subtract Ein Subtraktionsvorgang ohne Überlaufüberprüfung für numerische Operanden. a - b a - b
SubtractAssign Ein Subtraktions-Verbundzuordnungsvorgang ohne Überlaufüberprüfung für numerische Operanden. a -= b Wird nicht unterstützt.

Note

Um (a || b) und AndAlso (a && b) Vorgänge 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 lautet 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 lautet false.

Gilt für: