/// <summary> /// Invokes the underlying function of the command. /// </summary> /// <param name="toggle">The toggle status of the command.</param> /// <param name="context">The context under which the command is invoked.</param> /// <param name="args">The results of evaluating each argument given to the command.</param> /// <returns>A status code accompanied by text output.</returns> /// <exception cref="System.ArgumentNullException">Thrown when the given argument array is null.</exception> public EvaluationResult Invoke(Toggler toggle, EvaluationContext context, params Expression[] args) { if (args == null) { throw new ArgumentNullException("args"); } var e1 = new CommandInvocationEventArgs(context, toggle, args); OnInvocation(e1); if (e1.Cancel) { return(new EvaluationResult(CommonStatusCodes.InvocationCanceled, null, e1.CancelReason ?? "Invocation has stopped.")); } #if HCIE var e2 = new HostCommandInvocationEventArgs(this, context, toggle, args); context.Host.OnInvocation(e2); if (e2.Stop) { return(new EvaluationResult(CommonStatusCodes.InvocationCanceled, null, e2.StopReason ?? "Invocation has stopped.")); } #endif try { return(this.InvokeInternal(toggle, context, args)); } catch (Exception x) { return(new EvaluationResult(CommonStatusCodes.ClrException, null, x.ToString(), x)); } }
/// <summary> /// Raisese the <see cref="vCommands.Commands.Command.Invocation"/> event. /// </summary> /// <param name="e">A <see cref="vCommands.EventArguments.CommandInvocationEventArgs"/> that contains event data.</param> protected virtual void OnInvocation(CommandInvocationEventArgs e) { Invocation?.Invoke(this, e); }