HandleExternalEventActivity Klasse

Definition

Achtung

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

Definiert eine Workflow-Kommunikationsaktivität, mit der ein von einem lokalen Dienst ausgelöstes Ereignis behandelt wird.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.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.HandleExternalEventActivityValidator))]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public 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))>]
type HandleExternalEventActivity = class
    inherit Activity
    interface IEventActivity
    interface IActivityEventListener<QueueEventArgs>
    interface IDynamicPropertyTypeProvider
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.HandleExternalEventActivityValidator))>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type HandleExternalEventActivity = class
    inherit Activity
    interface IEventActivity
    interface IActivityEventListener<QueueEventArgs>
    interface IDynamicPropertyTypeProvider
Public Class HandleExternalEventActivity
Inherits Activity
Implements IActivityEventListener(Of QueueEventArgs), IDynamicPropertyTypeProvider, IEventActivity
Vererbung
HandleExternalEventActivity
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird das Erstellen und Festlegen von Werten für die HandleExternalEventActivity-Klasse dargestellt.The following code example shows how to create and set values for the HandleExternalEventActivity class. Dieses Codebeispiel stammt aus dem RaiseEventToLoadWorkflow SDK-Beispiel in der Datei DocumentApprovalWorkflow.cs.This code example is part of the RaiseEventToLoadWorkflow SDK sample from the DocumentApprovalWorkflow.cs file. Weitere Informationen finden Sie unter Raise Event to Load Workflow.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

Hinweise

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert.This material discusses types and namespaces that are obsolete. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Ein lokaler Dienst ist eine Klasse, mit der eine lokale Dienstschnittstelle implementiert wird (eine Schnittstelle, die mit ExternalDataExchangeAttribute markiert wird) und die ExternalDataExchangeService hinzugefügt wird.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 empfängt Daten, wenn vom ExternalDataExchangeService-Dienst mit von ExternalDataEventArgs abgeleiteten Ereignisdaten ein Ereignis ausgelöst wird.The HandleExternalEventActivity receives data when the ExternalDataExchangeService service raises an event with event data derived from ExternalDataEventArgs.

HandleExternalEventActivity ist eine Blockieraktivität.The HandleExternalEventActivity is a blocking activity.

Klassen, die von HandleExternalEventActivity abgeleitet werden, sollten nicht für die Implementierung der IActivityEventListener<T>-Schnittstelle verwendet werden, da die abgeleitete Klasse andernfalls nicht ordnungsgemäß ausgeführt wird.Classes that derive from HandleExternalEventActivity should not implement the IActivityEventListener<T> interface because the derived class does not execute correctly.

Konstruktoren

HandleExternalEventActivity()

Initialisiert eine neue Instanz der HandleExternalEventActivity-Klasse.Initializes a new instance of the HandleExternalEventActivity class.

HandleExternalEventActivity(String)

Initialisiert mithilfe des Aktivitätsnamens eine neue Instanz der HandleExternalEventActivity-Klasse.Initializes a new instance of the HandleExternalEventActivity class using the name of the activity.

Felder

CorrelationTokenProperty

Stellt die DependencyProperty dar, die sich auf die CorrelationToken-Eigenschaft bezieht.Represents the DependencyProperty that targets the CorrelationToken property.

EventNameProperty

Entspricht dem Namen eines Ereignisses, das in einer mit ExternalDataExchangeAttribute markierten Schnittstelle definiert ist.Corresponds to the name of an event that is defined in an interface that was marked with the ExternalDataExchangeAttribute.

InterfaceTypeProperty

Entspricht dem Namen der Schnittstelle, die mit ExternalDataExchangeAttribute markiert wurde.Corresponds to the name of the interface that was marked with the ExternalDataExchangeAttribute.

InvokedEvent

Definiert einen Ereignisdelegaten, der ausgeführt wird, nachdem die Aktivität das erwartete Ereignis vom lokalen Dienst empfangen hat.Defines an event delegate that is executed after the activity receives the expected event from the local service.

ParameterBindingsProperty

Stellt die DependencyProperty dar, die sich auf die ParameterBindings-Eigenschaft bezieht.Represents the DependencyProperty that targets the ParameterBindings property.

RolesProperty

Identifiziert die gültigen Benutzerrollen, die zum Senden von Nachrichten vom Host an diese Aktivität berechtigt sind.Identifies the valid user roles that are allowed to send messages from the host to this activity. Die zwei Typen unterstützter Rollen sind Active Directory und ASP.NET.The two types of supported roles are Active Directory and ASP.NET.

Eigenschaften

CorrelationToken

Ruft die Bindung ab oder legt sie auf CorrelationToken fest.Gets or sets the binding to a CorrelationToken.

Description

Ruft die benutzerdefinierte Beschreibung von Activity ab oder legt sie fest.Gets or sets the user-defined description of the Activity.

(Geerbt von Activity)
DesignMode

Ruft den Wert ab, der angibt, ob sich diese Instanz im Entwurfs- oder Laufzeitmodus befindet.Gets the value that indicates whether this instance is in design or run-time mode.

(Geerbt von DependencyObject)
Enabled

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob diese Instanz zur Ausführung und Validierung aktiviert ist.Gets or sets a value that indicates whether this instance is enabled for execution and validation.

(Geerbt von Activity)
EventName

Ruft den Namen des ausgelösten Ereignisses ab.Gets the name of the raised event. Diese Eigenschaft muss festgelegt werden, bevor lokale Kommunikation stattfinden kann.This property must be set before local communication can occur.

ExecutionResult

Ruft das ActivityExecutionResult des letzten Versuchs zur Ausführung dieser Instanz ab.Gets the ActivityExecutionResult of the last attempt to run this instance.

(Geerbt von Activity)
ExecutionStatus

Ruft den aktuellen ActivityExecutionStatus dieser Instanz ab.Gets the current ActivityExecutionStatus of this instance.

(Geerbt von Activity)
InterfaceType

Ruft den mit Attributen versehenen Schnittstellentyp ExternalDataExchangeAttribute des lokalen Diensts, dessen Ereignis behandelt wird, ab oder legt diesen fest.Gets or sets the ExternalDataExchangeAttribute attributed interface type of the local service whose event is handled. Diese Eigenschaft muss festgelegt werden, bevor lokale Kommunikation stattfinden kann.This property must be set before local communication can occur.

IsDynamicActivity

Ruft Informationen dazu ab, ob die Aktivität innerhalb des standardmäßigen ActivityExecutionContext der Workflowinstanz ausgeführt wird.Gets information about whether the activity is executing within the default ActivityExecutionContext of the workflow instance.

(Geerbt von Activity)
Name

Ruft den Namen dieser Instanz ab oder legt diesen fest.Gets or sets the name of this instance. Dieser Name muss die Namenskonventionen für Variablen der Programmiersprache einhalten, die im Workflowprojekt verwendet wird.This name must conform to the variable naming convention of the programming language that is being used in the Workflow project.

(Geerbt von Activity)
ParameterBindings

Ruft die Auflistung der Parameterbindungen ab.Gets the collection of parameter bindings.

Parent

Ruft die CompositeActivity ab, die Activity enthält.Gets the CompositeActivity that contains this Activity.

(Geerbt von Activity)
ParentDependencyObject

Ruft das übergeordnete DependencyObject im DependencyObject-Diagramm ab.Gets the parent DependencyObject in the DependencyObject graph.

(Geerbt von DependencyObject)
QualifiedName

Ruft den qualifizierten Namen der Aktivität ab.Gets the qualified name of the activity. Qualifizierte Aktivitätsnamen sind in einer Workflowinstanz immer eindeutig.Qualified activity names are always unique in a workflow instance.

(Geerbt von Activity)
Roles

Ruft einen Verweis auf eine Workflowrollenauflistung ab oder legt diesen fest.Gets or sets a reference to a workflow role collection.

Site

Ruft einen Verweis auf die Site-Komponente von DependencyObject ab oder legt diesen fest.Gets or sets a reference to the Site component of the DependencyObject.

(Geerbt von DependencyObject)
UserData

Ruft ein IDictionary ab, das dieser Klasseninstanz benutzerdefinierte Daten zuordnet.Gets an IDictionary that associates custom data with this class instance.

(Geerbt von DependencyObject)
WorkflowInstanceId

Ruft die Guid ab, die der Instanz zugeordnet ist.Gets the Guid associated with the instance.

(Geerbt von Activity)

Methoden

AddHandler(DependencyProperty, Object)

Fügt einen Handler für ein Ereignis von DependencyObject hinzu.Adds a handler for an event of a DependencyObject.

(Geerbt von DependencyObject)
Cancel(ActivityExecutionContext)

Bricht die Behandlung des Ereignisses ab.Cancels the handling of the event.

Clone()

Erstellt eine tiefe Kopie von Activity.Creates a deep copy of the Activity.

(Geerbt von Activity)
Dispose()

Gibt alle von DependencyObject verwendeten Ressourcen frei.Releases all the resources used by the DependencyObject.

(Geerbt von DependencyObject)
Dispose(Boolean)

Gibt die von DependencyObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources and optionally releases the managed resources used by DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Execute(ActivityExecutionContext)

Versucht die HandleExternalEventActivity auszuführen, die ActivityExecutionContext zugeordnet ist.Tries to run the HandleExternalEventActivity associated with the ActivityExecutionContext.

GetActivityByName(String)

Gibt die Instanz der Activity zurück, deren Name vom Satz aller Aktivitäten angefordert wird, die unter der Stammaktivität dieser Instanz ausgeführt werden; d.&#160;h. innerhalb des Workflows.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.

(Geerbt von Activity)
GetActivityByName(String, Boolean)

Gibt die Instanz der Activity zurück, deren Name vom Satz aller Aktivitäten unter der Stamm-Activity dieser Instanz angefordert wird, falls der zweite Parameter false ist, und deren Name unter der aktuellen Activity angefordert wird, falls der zweite Parameter true ist.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.

(Geerbt von Activity)
GetBinding(DependencyProperty)

Ermöglicht Zugriff auf die ActivityBind, die der bestimmten DependencyProperty zugeordnet ist.Provides access to the ActivityBind associated with the specific DependencyProperty.

(Geerbt von DependencyObject)
GetBoundValue(ActivityBind, Type)

Ruft das Object ab, das der Gegenstand von ActivityBind ist.Retrieves the Object that is the subject of an ActivityBind.

(Geerbt von DependencyObject)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetInvocationList<T>(DependencyProperty)

Ruft ein Array ab, das die Delegaten für die angegebene DependencyProperty enthält.Gets an array that contains the delegates for the specified DependencyProperty.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Stellt Zugriff auf den Wert der festgelegten DependencyProperty bereit.Provides access to the value of the designated DependencyProperty.

(Geerbt von DependencyObject)
GetValueBase(DependencyProperty)

Ermöglicht Zugriff auf das gebundene Objekt einer DependencyProperty und umgeht die GetValue(DependencyProperty)-Überschreibung.Provides access to the bound object of a DependencyProperty and bypasses the GetValue(DependencyProperty) override.

(Geerbt von DependencyObject)
HandleFault(ActivityExecutionContext, Exception)

Wird aufgerufen, wenn eine Ausnahme innerhalb des Kontexts der Ausführung dieser Instanz ausgelöst wird.Called when an exception is raised within the context of the execution of this instance.

Initialize(IServiceProvider)

Initialisiert das Ereignis beim Dienstanbieter.Initializes the event with the service provider.

InitializeProperties()

Führt die Initialisierung der Abhängigkeitseigenschaften durchPerforms initialization on dependency properties.

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

Abonniert EventHandler und ruft diesen Delegaten auf.Subscribes an EventHandler and invokes that delegate.

(Geerbt von Activity)
Invoke<T>(IActivityEventListener<T>, T)

Abonniert IActivityEventListener<T> und ruft diesen Delegaten auf.Subscribes an IActivityEventListener<T> and invokes that delegate.

(Geerbt von Activity)
IsBindingSet(DependencyProperty)

Gibt an, ob der Wert einer DependencyProperty als Bindung festgelegt ist.Indicates whether the value of a DependencyProperty is set as a binding. Siehe SetBinding(DependencyProperty, ActivityBind).See SetBinding(DependencyProperty, ActivityBind).

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MetaEquals(DependencyObject)

Bestimmt, ob metaproperties dieses DependencyObject den metaproperties des parametrisierten DependencyObject entspricht.Determines whether the metaproperties of this DependencyObject equals the metaproperties of the parameterized DependencyObject.

(Geerbt von DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

Wird bei jedem Laden von ActivityExecutionContext von der Workflowlaufzeit aufgerufen.Called by the workflow runtime whenever an ActivityExecutionContext is loaded. Beispielsweise wird diese Methode während der Erstellung von ActivityExecutionContext sowie bei jeder erneuten Erstellung von ActivityExecutionContext aufgerufen. Die erneute Erstellung findet statt, wenn eine Workflowinstanz aus dem permanenten Speicher geladen wird.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.

(Geerbt von Activity)
OnActivityExecutionContextUnload(IServiceProvider)

Wird bei jedem Entladen von ActivityExecutionContext von der Workflowlaufzeit aufgerufen.Called by the workflow runtime whenever an ActivityExecutionContext is unloaded. Beispielsweise wird diese Methode beim Beenden von ActivityExecutionContext sowie bei jedem Entladen von ActivityExecutionContext aufgerufen, wenn eine Workflowinstanz beibehalten wird.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.

(Geerbt von Activity)
OnClosed(IServiceProvider)

Wird von der Workflowlaufzeit als Teil des Übergangs der Aktivität in den Zustand Closed aufgerufen.Called by the workflow runtime as part of the activity's transition to the Closed state.

OnInvoked(EventArgs)

Wird unmittelbar nach dem Empfang des externen Ereignisses aufgerufen, um abgeleitete Klassen vor dem Schließen der Aktivität die Verarbeitung der eingehenden EventArgs zu ermöglichen.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)

Löst eine der angegebenen Abhängigkeitseigenschaft zugeordnete Event aus.Raises an Event associated with the specified dependency property.

(Geerbt von Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)

Löst das Ereignis aus, das der DependencyProperty zugeordnet ist, auf die verwiesen wird.Raises the event associated with the referenced DependencyProperty.

(Geerbt von Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Registriert die angegebene DependencyProperty für das Statusänderungsereignis.Registers the specified DependencyProperty for the status change event.

(Geerbt von Activity)
RemoveHandler(DependencyProperty, Object)

Entfernt einen EventHandler aus einer zugeordneten DependencyProperty.Removes an EventHandler from an associated DependencyProperty.

(Geerbt von DependencyObject)
RemoveProperty(DependencyProperty)

Entfernt DependencyProperty aus DependencyObject.Removes a DependencyProperty from the DependencyObject.

(Geerbt von DependencyObject)
Save(Stream)

Schreibt Activity dauerhaft in Stream.Writes the Activity to a Stream for persistence.

(Geerbt von Activity)
Save(Stream, IFormatter)

Schreibt Activity mithilfe des benutzerdefinierten Stream für Serialisierung dauerhaft in IFormatter.Writes the Activity to a Stream for persistence using the custom IFormatter provided for serialization.

(Geerbt von Activity)
SetBinding(DependencyProperty, ActivityBind)

Legt die ActivityBind für die angegebene DependencyProperty fest.Sets the ActivityBind for the specified DependencyProperty.

(Geerbt von DependencyObject)
SetBoundValue(ActivityBind, Object)

Legt den Wert der Ziel-ActivityBind fest.Sets the value of the target ActivityBind.

(Geerbt von DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)

Legt den Wert einer DependencyProperty fest, die schreibgeschützt ist.Sets the value of a DependencyProperty, which is read-only.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den Wert von DependencyProperty für das Objekt fest.Sets the value of the DependencyProperty to the object.

(Geerbt von DependencyObject)
SetValueBase(DependencyProperty, Object)

Legt den Wert von DependencyProperty auf das angegebene Object fest, wobei SetValue(DependencyProperty, Object) umgangen wird.Sets the value of the DependencyProperty to the specified Object, bypassing the SetValue(DependencyProperty, Object).

(Geerbt von DependencyObject)
ToString()

Stellt eine Zeichenfolge bereit, die diese Instanz darstellt.Provides a string that represents this instance.

(Geerbt von Activity)
TrackData(Object)

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.Informs the run-time tracking infrastructure of pending tracking information.

(Geerbt von Activity)
TrackData(String, Object)

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.Informs the run-time tracking infrastructure of pending tracking information.

(Geerbt von Activity)
Uninitialize(IServiceProvider)

Ermöglicht beim Überschreiben in einer abgeleiteten Klasse das Aufheben der Initialisierung durch einen Dienstanbieter für die Aktivität.When overridden in a derived class, provides un-initialization by a service provider for the activity.

(Geerbt von Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Hebt die Registrierung der angegebenen DependencyProperty für das Statusänderungsereignis auf.Un-registers the specified DependencyProperty for the status change event.

(Geerbt von Activity)

Ereignisse

Canceling

Tritt auf, wenn die Aktivitätsausführung abgebrochen wird.Occurs when the activity execution is canceled.

(Geerbt von Activity)
Closed

Tritt ein, wenn die Ausführung von Activity abgeschlossen wurde.Occurs when an Activity has completed execution.

(Geerbt von Activity)
Compensating

Tritt beim Ausführen einer Kompensierungsmethode in Activity auf.Occurs when running a compensation method on the Activity.

(Geerbt von Activity)
Executing

Tritt bei Ausführung von Activity ein.Occurs when the Activity is run.

(Geerbt von Activity)
Faulting

Tritt auf, wenn eine Ausnahme während des Ausführens der Instanz ausgelöst wird.Occurs when an exception is raised during the running of the instance.

(Geerbt von Activity)
Invoked

Tritt auf, wenn das externe Ereignis empfangen wird.Occurs when the external event is received.

StatusChanged

Tritt auf, wenn sich der ActivityExecutionStatus einer ausgeführten Activity ändert.Occurs when the ActivityExecutionStatus of a running Activity changes.

(Geerbt von Activity)

Explizite Schnittstellenimplementierungen

IActivityEventListener<QueueEventArgs>.OnEvent(Object, QueueEventArgs)

Definiert die Verarbeitungsprozedur, wenn das Abonnementereignis auftritt.Defines the processing procedure when the subscribed-to event occurs.

IComponent.Disposed

Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt.Represents the method that handles the Disposed event of a component.

(Geerbt von DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)

Gibt den Zugriffstyp für die angegebene Eigenschaft zurück.Returns the access type for the specified property.

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)

Gibt den Type der angegebenen Eigenschaft zurück.Returns the Type of the specified property.

IEventActivity.QueueName

Ruft den Namen der WorkflowQueue ab, in der die Aktivität auf das Eintreffen der Daten wartet.Gets the name of the WorkflowQueue on which the activity is waiting for data to arrive.

IEventActivity.Subscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)

Erstellt das Abonnement für die HandleExternalEventActivity-Aktivität für ein Ereignis.Creates the subscription of the HandleExternalEventActivity activity to an event.

IEventActivity.Unsubscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)

Bricht das Abonnement der HandleExternalEventActivity-Aktivität für ein Ereignis ab.Cancels the subscription of the HandleExternalEventActivity activity to an event.

Gilt für:

Siehe auch