StateActivity Klasse

Definition

Achtung

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

Stellt einen Zustand in StateMachineWorkflowActivity dar.Represents a state in a StateMachineWorkflowActivity.

public ref class StateActivity : System::Workflow::ComponentModel::CompositeActivity
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.StateActivity), "Resources.StateActivity.png")]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.StateActivityValidator))]
public class StateActivity : System.Workflow.ComponentModel.CompositeActivity
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.StateActivity), "Resources.StateActivity.png")]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.StateActivityValidator))]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class StateActivity : System.Workflow.ComponentModel.CompositeActivity
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.StateActivity), "Resources.StateActivity.png")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.StateActivityValidator))>]
type StateActivity = class
    inherit CompositeActivity
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.StateActivity), "Resources.StateActivity.png")>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.StateActivityValidator))>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type StateActivity = class
    inherit CompositeActivity
Public Class StateActivity
Inherits CompositeActivity
Vererbung
Abgeleitet
Attribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie eine neue Instanz der StateActivity-Klasse erstellt und anschließend dazu verwendet wird, einen einfachen Statuscomputer zwischen drei Zuständen wechseln zu lassen.The following code example shows how to create a new instance of the StateActivity class and use it implement a simple state machine to transition between 3 states. Dieses Codebeispiel stammt aus dem SimpleStateMachineWorkflow SDK-Beispiel in der Datei StateMachineWorkflow.cs.This code example is part of the SimpleStateMachineWorkflow SDK sample from the StateMachineWorkflow.cs file. Weitere Informationen finden Sie unter Simple State Machine.For more information, see Simple State Machine.

this.WhileLoop = new System.Workflow.Activities.WhileActivity();
this.Parallel = new System.Workflow.Activities.ParallelActivity();
this.Sequence1 = new System.Workflow.Activities.SequenceActivity();
this.Sequence2 = new System.Workflow.Activities.SequenceActivity();
this.ConsoleMessage1 = new System.Workflow.Activities.CodeActivity();
this.ConsoleMessage2 = new System.Workflow.Activities.CodeActivity();
//
// WhileLoop
//
this.WhileLoop.Activities.Add(this.Parallel);
codecondition1.Condition += new System.EventHandler<System.Workflow.Activities.ConditionalEventArgs>(this.WhileCondition);
this.WhileLoop.Condition = codecondition1;
this.WhileLoop.Name = "WhileLoop";
//
// Parallel
//
this.Parallel.Activities.Add(this.Sequence1);
this.Parallel.Activities.Add(this.Sequence2);
this.Parallel.Name = "Parallel";
Me.WhileLoop = New System.Workflow.Activities.WhileActivity()
Me.Parallel = New System.Workflow.Activities.ParallelActivity()
Me.Sequence1 = New System.Workflow.Activities.SequenceActivity()
Me.Sequence2 = New System.Workflow.Activities.SequenceActivity()
Me.ConsoleMessage1 = New System.Workflow.Activities.CodeActivity()
Me.ConsoleMessage2 = New System.Workflow.Activities.CodeActivity()
' 
' WhileLoop
' 
Me.WhileLoop.Activities.Add(Me.Parallel)
AddHandler codecondition1.Condition, AddressOf Me.WhileCondition
Me.WhileLoop.Condition = codecondition1
Me.WhileLoop.Name = "WhileLoop"
' 
' Parallel
' 
Me.Parallel.Activities.Add(Me.Sequence1)
Me.Parallel.Activities.Add(Me.Sequence2)
Me.Parallel.Name = "Parallel"

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.

StateActivity stellt einen Zustand in StateMachineWorkflowActivity dar.The StateActivity represents a State in a StateMachineWorkflowActivity. Zustandsaktivitäten können mindestens eine EventDrivenActivity-Klasse oder eine StateActivity-Klasse, eine StateInitializationActivity-Klasse und eine StateFinalizationActivity-Klasse beinhalten.State activities could contain one or more EventDrivenActivity, or StateActivity classes, one StateInitializationActivity class, and one StateFinalizationActivity class. SetState-Aktivitäten werden in EventHandlersActivity und StateInitializationActivity verwendet, um den Zustand des Workflows zu ändern.SetState activities are used inside an EventHandlersActivity and StateInitializationActivity to move the state of the workflow.

Beim Ausführen von StateActivity können nur Ereignisse empfangen werden, die von den EventDrivenActivity-Aktivitäten in StateActivity und auch den EventDrivenActivity-Aktivitäten, die den einschließenden StateActivity-Aktivitäten und der Stamm-Activity angefügt sind, behandelt werden.When a StateActivity is executing, the only events that can be received are the events that can be handled by the EventDrivenActivity activities in the StateActivity and also the EventDrivenActivity activities attached to the enclosing StateActivity activities and the root Activity.

Bei Beginn der Ausführung von StateActivity wird von StateActivity überprüft, ob eine StateInitializationActivity-Aktivität vorhanden ist.When the StateActivity starts running, the StateActivity will check to see whether a StateInitializationActivity activity is present or not. StateActivity kann über 0 (null) oder eine StateInitializationActivity-Aktivität verfügen.The StateActivity can have zero or one StateInitializationActivity activity. Wenn eine StateInitializationActivity-Aktivität vorhanden ist, wird StateInitializationActivity ausgeführt.If a StateInitializationActivity activity is present the StateInitializationActivity will be executed. Beim Beenden der StateInitializationActivity-Aktivität werden Ereignisse von StateActivity blockiert, damit StateActivity lediglich Ereignisse empfängt, die von den EventDrivenActivity-Aktivitäten behandelt werden können.As soon as the StateInitializationActivity activity finishes, the StateActivity blocks events so that the StateActivity only receives events that can be handled by its EventDrivenActivity activities.

StateActivity ist eine CompositeActivity. Dies bedeutet, dass die StateActivity-Aktivität andere Aktivitäten enthalten kann.The StateActivity is a CompositeActivity, meaning the StateActivity activity can contain other activities.

Konstruktoren

StateActivity()

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

StateActivity(String)

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

Felder

StateChangeTrackingDataKey

Beinhaltet den Zeichenfolgenwert des Änderungsverfolgungsdatenschlüssels; "StateActivity.StateChange".Holds the string value of the change tracking data key; "StateActivity.StateChange". Dieses Feld ist konstant.This field is a constant.

Eigenschaften

Activities

Ruft das Objekt ab, das die Auflistung (ActivityCollection) aller untergeordneten Aktivitäten darstellt.Gets the object representing the collection, ActivityCollection, of all child activities.

(Geerbt von CompositeActivity)
CanModifyActivities

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob die einzelnen Aktivitäten in Activities geändert werden können.Gets or sets a value which controls whether the individual activities within Activities can be modified.

(Geerbt von CompositeActivity)
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)
EnabledActivities

Ruft die schreibgeschützte Auflistung ab, die die Teilmenge der aktivierten Activities darstellt.Gets the read-only collection that represents the subset of Activities that are enabled.

(Geerbt von CompositeActivity)
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)
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)
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)
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)
ApplyWorkflowChanges(WorkflowChanges)

Übernimmt das WorkflowChanges-Manifest im Parameter für diese Instanz.Applies the WorkflowChanges manifest in the parameter to this instance.

(Geerbt von CompositeActivity)
Cancel(ActivityExecutionContext)

Bricht die Ausführung von StateActivity ab.Cancels the execution of the StateActivity.

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)

Ruft Dispose(Boolean) für diese Instanz und optional Dispose() für alle untergeordneten Aktivitäten dieser Instanz auf.Calls Dispose(Boolean) on this instance, and optionally calls Dispose() on all child activities of this instance.

(Geerbt von CompositeActivity)
Equals(Object)

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

(Geerbt von Object)
Execute(ActivityExecutionContext)

Führt StateActivity aus.Executes the StateActivity.

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)
GetDynamicActivities(Activity)

Gibt ein Array zurück, das alle derzeit ausgeführten Instanzen der angegebenen Aktivität enthält.Returns an array that contains all of the currently executing instances of the specified activity.

(Geerbt von CompositeActivity)
GetDynamicActivity(String)

Ruft die ausgeführte Instanz der Activity ab, die dem angegebenen untergeordneten Aktivitätsnamen entspricht.Gets the executing instance of the Activity that corresponds to the specified child activity name.

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.

(Geerbt von CompositeActivity)
Initialize(IServiceProvider)

Initialisiert StateActivity mit dem Dienstanbieter.Initializes the StateActivity using the service provider.

InitializeProperties()

Führt Initialisierung von Abhängigkeitseigenschaften aus, wenn eine Überschreibung in einer abgeleiteten Klasse stattfindet.Performs initialization on dependency properties when overridden in a derived class.

(Geerbt von DependencyObject)
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)
OnActivityChangeAdd(ActivityExecutionContext, Activity)

Bestimmt, ob es sich bei der hinzugefügten Aktivität um EventDrivenActivity handelt und überprüft ggf., ob die neu hinzugefügte ereignisgesteuerte Aktivität abonniert werden muss.Determines if the activity being added is an EventDrivenActivity and if so, verifies whether the newly added event driven needs to be subscribed.

OnActivityChangeRemove(ActivityExecutionContext, Activity)

Wird aufgerufen, wenn eine Aktivität entfernt wird.Called when an activity is removed.

(Geerbt von CompositeActivity)
OnActivityExecutionContextLoad(IServiceProvider)

Wird von der Workflowruntime-Engine aufgerufen, wenn ActivityExecutionContext für diese Aktivität geladen wird.Called by the workflow runtime engine every time the ActivityExecutionContext for this activity is loaded.

(Geerbt von CompositeActivity)
OnActivityExecutionContextUnload(IServiceProvider)

Wird von der Workflowruntime-Engine aufgerufen, wenn ActivityExecutionContext für diese Aktivität entladen wird.Called by the workflow runtime engine every time the ActivityExecutionContext for this activity is unloaded.

(Geerbt von CompositeActivity)
OnClosed(IServiceProvider)

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

OnListChanged(ActivityCollectionChangeEventArgs)

Führt zusätzliche Verarbeitung aus, wenn sich die Activities-Eigenschaft ändert.Performs additional processing when the Activities property changes.

(Geerbt von CompositeActivity)
OnListChanging(ActivityCollectionChangeEventArgs)

Ereignis, das auftritt, bevor eine Änderung an den zugrunde liegenden Activities vorgenommen wird.Event that occurs before a change being made to the underlying Activities.

(Geerbt von CompositeActivity)
OnWorkflowChangesCompleted(ActivityExecutionContext)

Wird nach Änderungen an der Auflistungs-Activities dieser Instanz aufgerufen.Called after changes have been made to the collection Activities of this instance.

(Geerbt von CompositeActivity)
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)

Wird von der Workflowruntime-Engine aufgerufen, wenn eine Aktivität vom Zustand Closed in den Zustand Initialized wechselt.Called by the workflow runtime engine when an activity transitions into the Closed state from the Initialized state.

(Geerbt von CompositeActivity)
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)
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

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)

Gilt für: