WorkflowEventArgs Třída

Definice

Obor názvů:

System.Workflow.Runtime

Sestavení:

System.Workflow.Runtime.dll

Upozornění

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Poskytuje data pro události pracovního postupu.

public ref class WorkflowEventArgs : EventArgs

[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class WorkflowEventArgs : EventArgs

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WorkflowEventArgs = class
    inherit EventArgs

Public Class WorkflowEventArgs
Inherits EventArgs

Dědičnost

Object

EventArgs

WorkflowEventArgs

Odvozené

System.Workflow.Runtime.WorkflowCompletedEventArgs

System.Workflow.Runtime.WorkflowSuspendedEventArgs

System.Workflow.Runtime.WorkflowTerminatedEventArgs

Atributy

ObsoleteAttribute

Příklady

Následující příklad kódu ukazuje, jak získat WorkflowInstance objekt pomocí WorkflowInstance vlastnosti, když je volána metoda obslužné rutiny události. Když dojde k WorkflowIdled události, zavolá se OnWorkflowIdled metoda definovaná v tomto příkladu. Určuje, který pracovní postup je nečinný pomocí WorkflowInstance vlastnosti a poté získá kolekci položek zařazených do fronty pro instanci pracovního postupu voláním GetWorkflowQueueData metody . Kód iteruje kolekci, aby zjistil, která aktivita čeká na událost, která pracovní postup neurčovala. Pak odešle výjimku do fronty pracovního postupu pomocí EnqueueItem metody spolu s názvem položky fronty událostí.

Tento příklad kódu je součástí ukázky canceling a Workflow SDK ze souboru Program.cs. Další informace najdete v tématu Zrušení pracovního postupu.

static void OnWorkflowIdled(object sender, WorkflowEventArgs e)
{
    WorkflowInstance workflow = e.WorkflowInstance;

    Console.WriteLine("\n...waiting for 3 seconds... \n");
    Thread.Sleep(3000);

    // what activity is blocking the workflow
    ReadOnlyCollection<WorkflowQueueInfo> wqi = workflow.GetWorkflowQueueData();
    foreach (WorkflowQueueInfo q in wqi)
    {
        EventQueueName eq = q.QueueName as EventQueueName;
        if (eq != null)
        {
            // get activity that is waiting for event
            ReadOnlyCollection<string> blockedActivity = q.SubscribedActivityNames;
            Console.WriteLine("Host: Workflow is blocked on " + blockedActivity[0]);

            // this event is never going to arrive eg. employee left the company
            // lets send an exception to this queue
            // it will either be handled by exception handler that was modeled in workflow
            // or the runtime will unwind running compensation handlers and exit the workflow
            Console.WriteLine("Host: This event is not going to arrive");
            Console.WriteLine("Host: Cancel workflow with unhandled exception");
            workflow.EnqueueItem(q.QueueName, new Exception("ExitWorkflowException"), null, null);
        }
    }
}

Shared Sub OnWorkflowIdled(ByVal sender As Object, ByVal e As WorkflowEventArgs)
    Dim workflow As WorkflowInstance = e.WorkflowInstance

    Console.WriteLine(vbCrLf + "...waiting for 3 seconds... " + vbCrLf)
    Thread.Sleep(3000)

    ' what activity is blocking the workflow
    Dim wqi As ReadOnlyCollection(Of WorkflowQueueInfo) = workflow.GetWorkflowQueueData()
    For Each q As WorkflowQueueInfo In wqi

        Dim eq As EventQueueName = TryCast(q.QueueName, EventQueueName)

        If eq IsNot Nothing Then
            ' get activity that is waiting for event
            Dim blockedActivity As ReadOnlyCollection(Of String) = q.SubscribedActivityNames
            Console.WriteLine("Host: Workflow is blocked on " + blockedActivity(0))

            ' this event is never going to arrive eg. employee left the company
            ' lets send an exception to this queue
            ' it will either be handled by exception handler that was modeled in workflow
            ' or the runtime will unwind running compensation handlers and exit the workflow
            Console.WriteLine("Host: This event is not going to arrive")
            Console.WriteLine("Host: Cancel workflow with unhandled exception")
            workflow.EnqueueItem(q.QueueName, New Exception("ExitWorkflowException"), Nothing, Nothing)
        End If
    Next
End Sub

Poznámky

Poznámka

V tomto materiálu jsou popsané zastaralé typy a obory názvů. Další informace naleznete v tématu Zastaralé typy ve Windows Workflow Foundation 4.5.

Události pracovního postupu jsou přidruženy k instanci pracovního postupu. Obsahuje WorkflowEventArgs přidruženou WorkflowInstance událost pracovního postupu. Objekt WorkflowEventArgs nebo objekt odvozený z WorkflowEventArgs třídy poskytuje data pro všechny události pracovního postupu ve WorkflowRuntime třídě. WorkflowEventArgs je základní třída pro WorkflowCompletedEventArgs, WorkflowSuspendedEventArgsa WorkflowTerminatedEventArgs.

Vlastnosti

WorkflowInstance

Zastaralé. Získá instanci pracovního postupu přidruženou k události pracovního postupu.

Metody

Equals(Object)	Zastaralé. Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Zastaralé. Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Zastaralé. Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Zastaralé. Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Zastaralé. Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Zrušení pracovního postupu