HandleExternalEventActivity.OnInvoked(EventArgs) Method

Reference

Definition

Namespace:: System.Workflow.Activities

Assembly:: System.Workflow.Activities.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Called just after the external event is received to allow derived classes to process the inbound EventArgs before the activity closes.

protected:
 virtual void OnInvoked(EventArgs ^ e);

protected virtual void OnInvoked (EventArgs e);

abstract member OnInvoked : EventArgs -> unit
override this.OnInvoked : EventArgs -> unit

Protected Overridable Sub OnInvoked (e As EventArgs)

Parameters

e: EventArgs

The EventArgs that are received from the external event that was just received.

Examples

The following example shows an implementation of the OnInvoked method. This example is from the Correlated Local Service SDK sample, from the TaskCompleted.cs file. For more information, see Correlated Local Service Sample.

private WorkflowQueue CreateQueue(ActivityExecutionContext context)
{
    Console.WriteLine("CreateQueue");
    WorkflowQueuingService qService = context.GetService<WorkflowQueuingService>();

    if (!qService.Exists(this.QueueName))
    {
        qService.CreateWorkflowQueue(this.QueueName, true);
    }

    return qService.GetWorkflowQueue(this.QueueName);
}

Private Function CreateQueue(ByVal context As ActivityExecutionContext) As WorkflowQueue
    Console.WriteLine("CreateQueue")
    Dim qService As WorkflowQueuingService = context.GetService(Of WorkflowQueuingService)()

    If Not qService.Exists(Me.queueName) Then
        qService.CreateWorkflowQueue(Me.queueName, True)
    End If

    Return qService.GetWorkflowQueue(Me.QueueName)
End Function

Remarks

The most common use of the OnInvoked method in derived classes is to extract members from the received EventArgs to set the values of the derived-classed activity's public properties.

Applies to

Jaa