WorkflowApplication.Cancel 메서드

정의

네임스페이스:

System.Activities

어셈블리:

System.Activities.dll

워크플로 인스턴스를 취소합니다.

오버로드

Cancel()	워크플로 인스턴스를 취소합니다.
Cancel(TimeSpan)	지정한 시간 제한 간격을 사용하여 워크플로 인스턴스를 취소합니다.

설명

이 메서드는 워크플로 instance 취소를 예약합니다. 취소가 완료되면 알림을 받도록 핸들을 Completed 사용합니다.

기본적으로 취소 작업은 30초 후에 완료되어야 합니다. 그렇지 않으면 이 TimeoutException throw됩니다.

Cancel()

워크플로 인스턴스를 취소합니다.

public:
 void Cancel();

public void Cancel ();

member this.Cancel : unit -> unit

Public Sub Cancel ()

예제

다음 예제에서는 WorkflowApplication을 사용하여 워크플로를 호스트합니다. WorkflowApplication instance 지정된 워크플로 정의를 사용하여 생성되고, 원하는 워크플로 수명 주기 이벤트가 처리되고, 워크플로가 호출을 통해 Run호출됩니다. 워크플로가 시작된 후 가 Cancel 호출됩니다. 워크플로가 취소되면 콘솔에 다음 출력이 표시됩니다.

Starting the workflow.   
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.   
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled  
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.  

Activity wf = new Sequence
{
    Activities =
     {
         new WriteLine
         {
             Text = "Starting the workflow."
         },
         new Delay
         {
             Duration = TimeSpan.FromSeconds(5)
         },
         new WriteLine
         {
             Text = "Ending the workflow."
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Subscribe to any desired workflow lifecycle events.
wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)
{
    if (e.CompletionState == ActivityInstanceState.Faulted)
    {
        Console.WriteLine("Workflow {0} Terminated.", e.InstanceId);
        Console.WriteLine("Exception: {0}\n{1}",
            e.TerminationException.GetType().FullName,
            e.TerminationException.Message);
    }
    else if (e.CompletionState == ActivityInstanceState.Canceled)
    {
        Console.WriteLine("Workflow {0} Canceled.", e.InstanceId);
    }
    else
    {
        Console.WriteLine("Workflow {0} Completed.", e.InstanceId);
    }
};

// Run the workflow.
wfApp.Run();

Thread.Sleep(TimeSpan.FromSeconds(1));

wfApp.Cancel();

설명

이 메서드는 워크플로 instance 취소를 예약합니다. 취소가 완료되면 알림을 받도록 처리기를 Completed 사용합니다.

기본적으로 취소 작업은 30초 후에 완료되어야 합니다. 그렇지 않으면 이 TimeoutException throw됩니다.

Cancel(TimeSpan)

지정한 시간 제한 간격을 사용하여 워크플로 인스턴스를 취소합니다.

public:
 void Cancel(TimeSpan timeout);

public void Cancel (TimeSpan timeout);

member this.Cancel : TimeSpan -> unit

Public Sub Cancel (timeout As TimeSpan)

매개 변수

timeout

TimeSpan

작업이 취소되고 TimeoutException이 throw되기 전에 취소 작업을 완료해야 하는 간격입니다.

예제

다음 예제에서는 WorkflowApplication을 사용하여 워크플로를 호스트합니다. WorkflowApplication instance 지정된 워크플로 정의를 사용하여 생성되고, 원하는 워크플로 수명 주기 이벤트가 처리되고, 워크플로가 호출을 통해 Run호출됩니다. 워크플로가 시작된 후 가 Cancel 호출됩니다. 워크플로가 취소되면 콘솔에 다음 출력이 표시됩니다.

Starting the workflow.   
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Idle.   
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Canceled  
Workflow bcce00c2-d323-42c2-8c25-19ff0c4b6dac Unloaded.  

Activity wf = new Sequence
{
    Activities =
     {
         new WriteLine
         {
             Text = "Starting the workflow."
         },
         new Delay
         {
             Duration = TimeSpan.FromSeconds(5)
         },
         new WriteLine
         {
             Text = "Ending the workflow."
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Subscribe to any desired workflow lifecycle events.
wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)
{
    if (e.CompletionState == ActivityInstanceState.Faulted)
    {
        Console.WriteLine("Workflow {0} Terminated.", e.InstanceId);
        Console.WriteLine("Exception: {0}\n{1}",
            e.TerminationException.GetType().FullName,
            e.TerminationException.Message);
    }
    else if (e.CompletionState == ActivityInstanceState.Canceled)
    {
        Console.WriteLine("Workflow {0} Canceled.", e.InstanceId);
    }
    else
    {
        Console.WriteLine("Workflow {0} Completed.", e.InstanceId);
    }
};

// Run the workflow.
wfApp.Run();

Thread.Sleep(TimeSpan.FromSeconds(1));

wfApp.Cancel();

설명

이 메서드는 워크플로 instance 취소를 예약합니다. 취소가 완료되면 알림을 받도록 처리기를 Completed 사용합니다.