DynamicObject.TryUnaryOperation(UnaryOperationBinder, Object) Método

Definição

Namespace:

System.Dynamic

Assembly:

System.Linq.Expressions.dll

Origem:

DynamicObject.cs

Fornece implementação para operações unárias. As classes derivadas da classe DynamicObject podem substituir este método para especificar o comportamento dinâmico para operações como uma negação, incremento ou decremento.

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

Parâmetros

binder

UnaryOperationBinder

Fornece informações sobre a operação unária. A binder.Operation propriedade retorna um ExpressionType objeto . Por exemplo, para a negativeNumber = -number instrução , em que number é derivada da DynamicObject classe , binder.Operation retorna "Negate".

result

Object

O resultado da operação unária.

Retornos

Boolean

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

Exemplos

Suponha que você precise de uma estrutura de dados para armazenar representações textuais e numéricas de números e que deseja definir uma operação de negação matemática para esses dados.

O exemplo de código a seguir demonstra a DynamicNumber classe , que é derivada da DynamicObject classe . DynamicNumber substitui o TryUnaryOperation método para habilitar a operação de negação matemática. Também substitui os TrySetMember métodos e TryGetMember para habilitar o acesso aos elementos.

Neste exemplo, há suporte apenas para a operação de negação matemática. Se você tentar escrever uma instrução como negativeNumber = +number, ocorrerá uma exceção em tempo de execução.

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

Comentários

Classes derivadas da DynamicObject classe podem substituir esse método para especificar como as operações unárias 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 a um idioma é gerada.)

Esse método é chamado quando você tem operações unárias, como negação, incremento ou decremento. Por exemplo, se o TryUnaryOperation método for substituído, esse método será invocado automaticamente para instruções como negativeNumber = -number, em que number é derivado da DynamicObject classe .

Você pode obter informações sobre o tipo da operação unária usando a Operation propriedade do binder parâmetro .

Se o objeto dinâmico for usado apenas em C# e Visual Basic, a binder.Operation propriedade poderá ter um dos seguintes valores da ExpressionType enumeração. No entanto, em outras linguagens, como IronPython ou IronRuby, você pode ter outros valores.

Valor	Descrição	C#	Visual Basic
Decrement	Uma operação decremento unário.	a--	Não há suporte.
Increment	Uma operação de incremento unário.	a++	Não há suporte.
Negate	Uma negação aritmética.	-a	-a
Not	Uma negação lógica.	!a	Not a
OnesComplement	Um complemento ones.	~a	Não há suporte.
IsFalse	Um valor de condição falsa.	a && b	Não há suporte.
IsTrue	Um valor de condição verdadeiro.	a || b	Não há suporte.
UnaryPlus	Uma vantagem unária.	+a	+a

Observação

Para implementar OrElse operações (a || b) e AndAlso (a && b) para objetos dinâmicos em C#, convém implementar o TryUnaryOperation método e o TryBinaryOperation método .

A OrElse operação consiste na operação unária IsTrue e na operação binária Or . A Or operação será executada somente se o resultado da IsTrue operação for false.

A AndAlso operação consiste na operação unária IsFalse e na operação binária And . A And operação será executada somente se o resultado da IsFalse operação for false.