HandleExternalEventActivity 클래스

정의

경고

이 API는 현재 사용되지 않습니다.

로컬 서비스에서 발생한 이벤트를 처리하는 데 사용되는 워크플로 통신 활동을 정의합니다.Defines a workflow communication activity that is used to handle an event that is raised by a local service.

public ref class HandleExternalEventActivity : System::Workflow::ComponentModel::Activity, System::Workflow::Activities::IEventActivity, System::Workflow::ComponentModel::IActivityEventListener<System::Workflow::ComponentModel::QueueEventArgs ^>, System::Workflow::ComponentModel::IDynamicPropertyTypeProvider
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.HandleExternalEventActivityValidator))]
public class HandleExternalEventActivity : System.Workflow.ComponentModel.Activity, System.Workflow.Activities.IEventActivity, System.Workflow.ComponentModel.IActivityEventListener<System.Workflow.ComponentModel.QueueEventArgs>, System.Workflow.ComponentModel.IDynamicPropertyTypeProvider
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.HandleExternalEventActivityValidator))]
public class HandleExternalEventActivity : System.Workflow.ComponentModel.Activity, System.Workflow.Activities.IEventActivity, System.Workflow.ComponentModel.IActivityEventListener<System.Workflow.ComponentModel.QueueEventArgs>, System.Workflow.ComponentModel.IDynamicPropertyTypeProvider
type HandleExternalEventActivity = class
    inherit Activity
    interface IEventActivity
    interface IActivityEventListener<QueueEventArgs>
    interface IDynamicPropertyTypeProvider
Public Class HandleExternalEventActivity
Inherits Activity
Implements IActivityEventListener(Of QueueEventArgs), IDynamicPropertyTypeProvider, IEventActivity
상속
HandleExternalEventActivity
특성
구현

예제

다음 코드 예제에서는 HandleExternalEventActivity 클래스에 대한 값을 만들고 설정하는 방법을 보여 줍니다.The following code example shows how to create and set values for the HandleExternalEventActivity class. 이 코드 예제는 DocumentApprovalWorkflow.cs 파일에 있는 RaiseEventToLoadWorkflow SDK 샘플의 일부입니다.This code example is part of the RaiseEventToLoadWorkflow SDK sample from the DocumentApprovalWorkflow.cs file. 자세한 내용은 부하에 이벤트를 발생 시킬 워크플로합니다.For more information, see Raise Event To Load Workflow.

this.Car.Name = "Car";
this.Car.ExecuteCode += new System.EventHandler(this.Car_ExecuteCode);
this.Car.SetValue(System.Workflow.Activities.ConditionedActivityGroup.WhenConditionProperty, codecondition1);
codecondition2.Condition += new System.EventHandler<System.Workflow.Activities.ConditionalEventArgs>(this.AirlineCondition);
Me.Car.Name = "Car"
AddHandler Car.ExecuteCode, AddressOf Me.Car_ExecuteCode
Me.Car.SetValue(System.Workflow.Activities.ConditionedActivityGroup.WhenConditionProperty, codecondition1)
AddHandler codecondition2.Condition, AddressOf Me.AirlineCondition

설명

참고

이 자료에서는 더 이상 사용되지 않는 형식과 네임스페이스에 대해 설명합니다.This material discusses types and namespaces that are obsolete. 자세한 내용은 Deprecated Types in Windows Workflow Foundation 4.5(Windows Workflow Foundation 4.5에서 사용되지 않는 형식)를 참조하세요.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

로컬 서비스는 로컬 서비스 인터페이스(ExternalDataExchangeAttribute로 표시된 인터페이스)를 구현하는 클래스이며 ExternalDataExchangeService에 추가됩니다.A local service is a class that implements a local service interface (an interface that is marked with ExternalDataExchangeAttribute) and is added to the ExternalDataExchangeService.

HandleExternalEventActivity에서는 ExternalDataExchangeService 서비스가 ExternalDataEventArgs에서 파생된 이벤트 데이터로 이벤트를 발생시키면 데이터를 받습니다.The HandleExternalEventActivity receives data when the ExternalDataExchangeService service raises an event with event data derived from ExternalDataEventArgs.

HandleExternalEventActivity는 차단 활동입니다.The HandleExternalEventActivity is a blocking activity.

HandleExternalEventActivity에서 파생되는 클래스는 IActivityEventListener<T> 인터페이스를 구현하지 않아야 합니다. 그렇지 않으면 파생 클래스가 올바로 실행되지 않습니다.Classes that derive from HandleExternalEventActivity should not implement the IActivityEventListener<T> interface because the derived class does not execute correctly.

생성자

HandleExternalEventActivity()

HandleExternalEventActivity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the HandleExternalEventActivity class.

HandleExternalEventActivity(String)

활동 이름을 사용하여 HandleExternalEventActivity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the HandleExternalEventActivity class using the name of the activity.

필드

CorrelationTokenProperty

DependencyProperty 속성을 대상으로 하는 CorrelationToken를 나타냅니다.Represents the DependencyProperty that targets the CorrelationToken property.

EventNameProperty

ExternalDataExchangeAttribute로 표시된 인터페이스에 정의된 이벤트의 이름에 해당합니다.Corresponds to the name of an event that is defined in an interface that was marked with the ExternalDataExchangeAttribute.

InterfaceTypeProperty

ExternalDataExchangeAttribute로 표시된 인터페이스의 이름에 해당합니다.Corresponds to the name of the interface that was marked with the ExternalDataExchangeAttribute.

InvokedEvent

활동이 로컬 서비스에서 예상된 이벤트를 받으면 실행되는 이벤트 대리자를 정의합니다.Defines an event delegate that is executed after the activity receives the expected event from the local service.

ParameterBindingsProperty

DependencyProperty 속성을 대상으로 하는 ParameterBindings를 나타냅니다.Represents the DependencyProperty that targets the ParameterBindings property.

RolesProperty

호스트에서 이 활동으로 메시지를 보낼 수 있는 유효한 사용자 역할을 확인합니다.Identifies the valid user roles that are allowed to send messages from the host to this activity. 지원되는 두 가지 역할 유형은 Active Directory와 ASP.NET입니다.The two types of supported roles are Active Directory and ASP.NET.

속성

CorrelationToken

CorrelationToken에 바인딩을 가져오거나 설정합니다.Gets or sets the binding to a CorrelationToken.

Description

Activity에 대한 사용자 정의 설명을 가져오거나 설정합니다.Gets or sets the user-defined description of the Activity.

(다음에서 상속됨 Activity)
DesignMode

이 인스턴스가 디자인 모드 또는 런타임 모드에 있는지 나타내는 값을 가져옵니다.Gets the value that indicates whether this instance is in design or run-time mode.

(다음에서 상속됨 DependencyObject)
Enabled

실행 및 유효성 검사에 이 인스턴스를 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether this instance is enabled for execution and validation.

(다음에서 상속됨 Activity)
EventName

발생한 이벤트의 이름을 가져옵니다.Gets the name of the raised event. 이 속성을 설정해야 로컬 통신이 이루어집니다.This property must be set before local communication can occur.

ExecutionResult

이 인스턴스를 실행하려는 마지막 시도의 ActivityExecutionResult를 가져옵니다.Gets the ActivityExecutionResult of the last attempt to run this instance.

(다음에서 상속됨 Activity)
ExecutionStatus

이 인스턴스의 현재 ActivityExecutionStatus를 가져옵니다.Gets the current ActivityExecutionStatus of this instance.

(다음에서 상속됨 Activity)
InterfaceType

이벤트를 처리하는 로컬 서비스의 ExternalDataExchangeAttribute 특성이 지정된 인터페이스 형식을 가져오거나 설정합니다.Gets or sets the ExternalDataExchangeAttribute attributed interface type of the local service whose event is handled. 이 속성을 설정해야 로컬 통신이 이루어집니다.This property must be set before local communication can occur.

IsDynamicActivity

활동이 워크플로 인스턴스의 기본 ActivityExecutionContext 내에서 실행 중인지 여부에 대한 정보를 가져옵니다.Gets information about whether the activity is executing within the default ActivityExecutionContext of the workflow instance.

(다음에서 상속됨 Activity)
Name

이 인스턴스의 이름을 가져오거나 설정합니다.Gets or sets the name of this instance. 이 이름은 워크플로 프로젝트에 사용되는 프로그래밍 언어의 변수 명명 규칙을 따라야 합니다This name must conform to the variable naming convention of the programming language that is being used in the Workflow project.

(다음에서 상속됨 Activity)
ParameterBindings

매개 변수 바인딩의 컬렉션을 가져옵니다.Gets the collection of parameter bindings.

Parent

CompositeActivity이 들어 있는 Activity을 가져옵니다.Gets the CompositeActivity that contains this Activity.

(다음에서 상속됨 Activity)
ParentDependencyObject

DependencyObject 그래프의 부모 DependencyObject를 가져옵니다.Gets the parent DependencyObject in the DependencyObject graph.

(다음에서 상속됨 DependencyObject)
QualifiedName

활동의 정규화된 이름을 가져옵니다.Gets the qualified name of the activity. 정규화된 활동 이름은 워크플로 인스턴스에서 항상 고유합니다.Qualified activity names are always unique in a workflow instance.

(다음에서 상속됨 Activity)
Roles

워크플로 역할 컬렉션에 대한 참조를 가져오거나 설정합니다.Gets or sets a reference to a workflow role collection.

Site

SiteDependencyObject 구성 요소에 대한 참조를 가져오거나 설정합니다.Gets or sets a reference to the Site component of the DependencyObject.

(다음에서 상속됨 DependencyObject)
UserData

사용자 지정 데이터를 이 클래스 인스턴스와 연결하는 IDictionary를 가져옵니다.Gets an IDictionary that associates custom data with this class instance.

(다음에서 상속됨 DependencyObject)
WorkflowInstanceId

인스턴스와 연결된 Guid를 가져옵니다.Gets the Guid associated with the instance.

(다음에서 상속됨 Activity)

메서드

AddHandler(DependencyProperty, Object)

DependencyObject 이벤트에 대한 처리기를 추가합니다.Adds a handler for an event of a DependencyObject.

(다음에서 상속됨 DependencyObject)
Cancel(ActivityExecutionContext)

이벤트 처리를 취소합니다.Cancels the handling of the event.

Clone()

Activity의 전체 복사본을 만듭니다.Creates a deep copy of the Activity.

(다음에서 상속됨 Activity)
Dispose()

DependencyObject에서 사용하는 리소스를 모두 해제합니다.Releases all the resources used by the DependencyObject.

(다음에서 상속됨 DependencyObject)
Dispose(Boolean)

DependencyObject에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제합니다.Releases the unmanaged resources and optionally releases the managed resources used by DependencyObject.

(다음에서 상속됨 DependencyObject)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Execute(ActivityExecutionContext)

HandleExternalEventActivity와 연결된 ActivityExecutionContext를 실행합니다.Tries to run the HandleExternalEventActivity associated with the ActivityExecutionContext.

GetActivityByName(String)

워크플로 내에 있는 이 인스턴스의 루트 활동에서 실행 중인 모든 활동 집합 중 이름이 요청된 Activity의 인스턴스를 반환합니다.Returns the instance of the Activity whose name is requested from the set of all activities running under the root activity of this instance, which is within the workflow.

(다음에서 상속됨 Activity)
GetActivityByName(String, Boolean)

두 번째 매개 변수가 false이면 이 인스턴스의 루트 Activity에 있는 모든 활동 집합에서, 두 번째 매개 변수가 true이면 현재 Activity에 있는 모든 활동 집합에서 이름이 요청된 Activity의 인스턴스를 반환합니다.Returns the instance of the Activity whose name is requested from the set of all activities under the root the Activity of this instance if the second parameter is false and under the current Activity if the second parameter is true.

(다음에서 상속됨 Activity)
GetBinding(DependencyProperty)

특정 ActivityBind와 연결된 DependencyProperty에 대한 액세스를 제공합니다.Provides access to the ActivityBind associated with the specific DependencyProperty.

(다음에서 상속됨 DependencyObject)
GetBoundValue(ActivityBind, Type)

Object의 주체인 ActivityBind를 검색합니다.Retrieves the Object that is the subject of an ActivityBind.

(다음에서 상속됨 DependencyObject)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetInvocationList<T>(DependencyProperty)

지정된 DependencyProperty의 대리자를 포함하는 배열을 가져옵니다.Gets an array that contains the delegates for the specified DependencyProperty.

(다음에서 상속됨 DependencyObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetValue(DependencyProperty)

지정된 DependencyProperty의 값에 대한 액세스를 제공합니다.Provides access to the value of the designated DependencyProperty.

(다음에서 상속됨 DependencyObject)
GetValueBase(DependencyProperty)

DependencyProperty의 바인딩된 개체에 액세스하는 데 사용할 수 있으며 GetValue(DependencyProperty) 재정의를 무시합니다.Provides access to the bound object of a DependencyProperty and bypasses the GetValue(DependencyProperty) override.

(다음에서 상속됨 DependencyObject)
HandleFault(ActivityExecutionContext, Exception)

이 인스턴스의 실행 컨텍스트 내에서 예외가 발생할 때 호출됩니다.Called when an exception is raised within the context of the execution of this instance.

Initialize(IServiceProvider)

서비스 공급자로 이벤트를 초기화합니다.Initializes the event with the service provider.

InitializeProperties()

종속성 속성에 대한 초기화를 수행합니다.Performs initialization on dependency properties.

Invoke<T>(EventHandler<T>, T)

EventHandler를 구독하고 해당 대리자를 호출합니다.Subscribes an EventHandler and invokes that delegate.

(다음에서 상속됨 Activity)
Invoke<T>(IActivityEventListener<T>, T)

IActivityEventListener<T>를 구독하고 해당 대리자를 호출합니다.Subscribes an IActivityEventListener<T> and invokes that delegate.

(다음에서 상속됨 Activity)
IsBindingSet(DependencyProperty)

DependencyProperty의 값이 바인딩으로 설정되었는지 여부를 나타냅니다.Indicates whether the value of a DependencyProperty is set as a binding. SetBinding(DependencyProperty, ActivityBind)을 참조하세요.See SetBinding(DependencyProperty, ActivityBind).

(다음에서 상속됨 DependencyObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MetaEquals(DependencyObject)

metapropertiesDependencyObject가 매개 변수화된 metapropertiesDependencyObject와 같은지 여부를 결정합니다.Determines whether the metaproperties of this DependencyObject equals the metaproperties of the parameterized DependencyObject.

(다음에서 상속됨 DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

ActivityExecutionContext가 로드될 때마다 워크플로 런타임에서 호출됩니다.Called by the workflow runtime whenever an ActivityExecutionContext is loaded. 예를 들어 이 메서드는 ActivityExecutionContext을 만드는 동안 및 워크플로 인스턴스가 영구 스토리지에서 로드되는 경우 ActivityExecutionContext를 다시 구체화할 때마다 호출됩니다.For example, this method is called during the creation of an ActivityExecutionContext as well as every time the ActivityExecutionContext is reincarnated when a workflow instance is loaded from persistent storage.

(다음에서 상속됨 Activity)
OnActivityExecutionContextUnload(IServiceProvider)

ActivityExecutionContext가 언로드될 때마다 워크플로 런타임에서 호출됩니다.Called by the workflow runtime whenever an ActivityExecutionContext is unloaded. 예를 들어, 이 메서드는 ActivityExecutionContext를 완료하는 동안 및 워크플로 인스턴스가 유지되는 경우 ActivityExecutionContext를 언로드할 때마다 호출됩니다.For example, this method is called during completion of an ActivityExecutionContext as well as every time the ActivityExecutionContext is unloaded when a workflow instance is persisted.

(다음에서 상속됨 Activity)
OnClosed(IServiceProvider)

활동이 Closed 상태로 전환되는 과정의 일부로 워크플로 런타임에서 호출됩니다.Called by the workflow runtime as part of the activity's transition to the Closed state.

OnInvoked(EventArgs)

활동이 종료되기 전에 파생 클래스에서 인바운드 EventArgs를 처리할 수 있도록 외부 이벤트를 받으면 바로 호출됩니다.Called just after the external event is received to allow derived classes to process the inbound EventArgs before the activity closes.

RaiseEvent(DependencyProperty, Object, EventArgs)

지정된 종속성 속성과 연결된 Event를 발생시킵니다.Raises an Event associated with the specified dependency property.

(다음에서 상속됨 Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)

참조된 DependencyProperty와 연결된 이벤트를 발생시킵니다.Raises the event associated with the referenced DependencyProperty.

(다음에서 상속됨 Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

상태 변경 이벤트에 대해 지정된 DependencyProperty를 등록합니다.Registers the specified DependencyProperty for the status change event.

(다음에서 상속됨 Activity)
RemoveHandler(DependencyProperty, Object)

연결된 EventHandler에서 DependencyProperty를 제거합니다.Removes an EventHandler from an associated DependencyProperty.

(다음에서 상속됨 DependencyObject)
RemoveProperty(DependencyProperty)

DependencyProperty에서 DependencyObject 개체를 제거합니다.Removes a DependencyProperty from the DependencyObject.

(다음에서 상속됨 DependencyObject)
Save(Stream)

지속성을 위해 ActivityStream에 씁니다.Writes the Activity to a Stream for persistence.

(다음에서 상속됨 Activity)
Save(Stream, IFormatter)

serialization에 제공된 사용자 지정 Activity를 사용하여 지속성을 위해 StreamIFormatter에 씁니다.Writes the Activity to a Stream for persistence using the custom IFormatter provided for serialization.

(다음에서 상속됨 Activity)
SetBinding(DependencyProperty, ActivityBind)

지정된 ActivityBind에 대한 DependencyProperty를 설정합니다.Sets the ActivityBind for the specified DependencyProperty.

(다음에서 상속됨 DependencyObject)
SetBoundValue(ActivityBind, Object)

대상 ActivityBind의 값을 설정합니다.Sets the value of the target ActivityBind.

(다음에서 상속됨 DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)

읽기 전용인 DependencyProperty의 값을 설정합니다.Sets the value of a DependencyProperty, which is read-only.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyProperty의 값을 개체에 설정합니다.Sets the value of the DependencyProperty to the object.

(다음에서 상속됨 DependencyObject)
SetValueBase(DependencyProperty, Object)

DependencyProperty를 무시하고 Object의 값을 지정된 SetValue(DependencyProperty, Object)에 설정합니다.Sets the value of the DependencyProperty to the specified Object, bypassing the SetValue(DependencyProperty, Object).

(다음에서 상속됨 DependencyObject)
ToString()

이 인스턴스를 나타내는 문자열을 제공합니다.Provides a string that represents this instance.

(다음에서 상속됨 Activity)
TrackData(Object)

런타임 추적 인프라에 보류 중인 추적 정보를 알립니다.Informs the run-time tracking infrastructure of pending tracking information.

(다음에서 상속됨 Activity)
TrackData(String, Object)

런타임 추적 인프라에 보류 중인 추적 정보를 알립니다.Informs the run-time tracking infrastructure of pending tracking information.

(다음에서 상속됨 Activity)
Uninitialize(IServiceProvider)

파생 클래스에서 재정의되는 경우 서비스 공급자에 의한 활동의 초기화 해제를 제공합니다.When overridden in a derived class, provides un-initialization by a service provider for the activity.

(다음에서 상속됨 Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

상태 변경 이벤트에 대해 지정된 DependencyProperty를 등록 취소합니다.Un-registers the specified DependencyProperty for the status change event.

(다음에서 상속됨 Activity)

이벤트

Canceling

활동 실행이 취소될 때 발생합니다.Occurs when the activity execution is canceled.

(다음에서 상속됨 Activity)
Closed

Activity에서 실행을 완료했을 때 발생합니다.Occurs when an Activity has completed execution.

(다음에서 상속됨 Activity)
Compensating

Activity에서 보정 메서드를 실행할 때 발생합니다.Occurs when running a compensation method on the Activity.

(다음에서 상속됨 Activity)
Executing

Activity가 실행될 때 발생합니다.Occurs when the Activity is run.

(다음에서 상속됨 Activity)
Faulting

인스턴스를 실행하는 동안 예외가 나타날 때 발생합니다.Occurs when an exception is raised during the running of the instance.

(다음에서 상속됨 Activity)
Invoked

외부 이벤트를 받을 때 발생합니다.Occurs when the external event is received.

StatusChanged

실행 중인 ActivityExecutionStatusActivity가 변경될 때 발생합니다.Occurs when the ActivityExecutionStatus of a running Activity changes.

(다음에서 상속됨 Activity)

명시적 인터페이스 구현

IActivityEventListener<QueueEventArgs>.OnEvent(Object, QueueEventArgs)

구독 대상 이벤트가 발생할 때의 처리 절차를 정의합니다.Defines the processing procedure when the subscribed-to event occurs.

IComponent.Disposed

구성 요소의 Disposed 이벤트를 처리하는 메서드를 나타냅니다.Represents the method that handles the Disposed event of a component.

(다음에서 상속됨 DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)

지정된 속성의 액세스 형식을 반환합니다.Returns the access type for the specified property.

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)

지정된 속성의 Type을 반환합니다.Returns the Type of the specified property.

IEventActivity.QueueName

이 활동이 데이터 도착을 기다리는 WorkflowQueue의 이름을 가져옵니다.Gets the name of the WorkflowQueue on which the activity is waiting for data to arrive.

IEventActivity.Subscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)

이벤트에 대한 HandleExternalEventActivity 활동의 구독을 만듭니다.Creates the subscription of the HandleExternalEventActivity activity to an event.

IEventActivity.Unsubscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)

이벤트에 대한 HandleExternalEventActivity 활동의 구독을 취소합니다.Cancels the subscription of the HandleExternalEventActivity activity to an event.

적용 대상

추가 정보