Freigeben über


Activity Klasse

Definition

Achtung

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

Stellt den grundlegenden Baustein von Workflows dar. Activity ist die Basisklasse für alle Aktivitäten.

public ref class Activity : System::Workflow::ComponentModel::DependencyObject
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")]
[System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))]
[System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")]
public class Activity : System.Workflow.ComponentModel.DependencyObject
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")]
[System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))]
[System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class Activity : System.Workflow.ComponentModel.DependencyObject
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")>]
[<System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))>]
[<System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")>]
type Activity = class
    inherit DependencyObject
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")>]
[<System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))>]
[<System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type Activity = class
    inherit DependencyObject
Public Class Activity
Inherits DependencyObject
Vererbung
Abgeleitet
Attribute

Beispiele

In diesem Beispiel wird eine Aktivität definiert, deren Zweck das Senden einer E-Mail ist. Die Aktivität definiert die Eigenschaft Subject, die in ihrer Implementierung eine Abhängigkeitseigenschaft verwendet. Andere Eigenschaften können auf eine ähnliche Weise definiert werden. Die Execute-Methode wird überschrieben, um die Logik für das Senden der E-Mail bereitzustellen. Ein vollständiges Beispiel finden Sie im Beispiel für Email-Aktivität senden.

public class SendEmail : Activity  
{  
    public static readonly DependencyProperty SubjectProperty =  
        DependencyProperty.Register("Subject", typeof(string), typeof(SendEmail));  

    public string Subject  
    {  
        get { return base.GetValue(SubjectProperty) as string; }  
        set { base.SetValue(SubjectProperty, value); }  
    }  

    // Define other properties...  

    protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)  
    {  
        // Logic to send the email goes here...  
        return ActivityExecutionStatus.Closed;  
    }  
}  

Hinweise

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.

Activity ist der grundlegende Baustein von Workflows. Eine Activity definiert eine Reihe von Eigenschaften und Ereignissen (wie jede beliebige Klasse) zusammen mit einer Ausführungslogik, die das Laufzeitverhalten der Aktivität definiert. Einer Activity kann ein Satz zusätzlicher Komponenten zugeordnet werden. Diese umfassen ein Validierungssteuerelement, einen Codegenerator, benutzerdefinierte Serialisierungsprogramme und einen Designer, sind aber nicht darauf beschränkt.

Ein allgemeiner Satz von auf der Activity-Basisklasse definierten Eigenschaften wird für alle Aktivitäten freigegeben. Jede Activity kann eigene zusätzliche Eigenschaften gemäß ihren Anforderungen durch Erweitern dieser Klasse deklarieren. Da Activity von DependencyObject abgeleitet wird, können Eigenschaften als Standard-CLR-Eigenschaften und Abhängigkeitseigenschaften definiert werden.

Die Ausführungslogik von Activity erfüllt einen Vertrag zwischen Activity und der Workflowlaufzeit. Die Ausführungslogik von Activity muss nachvollziehbar dokumentiert werden, damit ein Workflowentwickler, der Activity verwendet, über das Verhalten informiert ist. Die Ausführungslogik selbst wird dem Workflowentwickler, der die Aktivität in einen Workflow einbindet, nicht angezeigt, da die Ausführungslogik Teil eines verbindlichen Vertrags zwischen der Workflowlaufzeit und Activity ist.

Konstruktoren

Activity()
Veraltet.

Initialisiert eine neue Instanz der Activity-Klasse.

Activity(String)
Veraltet.

Initialisiert eine neue Instanz der Activity-Klasse, während Name initialisiert wird.

Felder

ActivityContextGuidProperty
Veraltet.

Die DependencyProperty, die für die Guid von ActivityExecutionContext steht, der der Activity zugeordnet ist.

CancelingEvent
Veraltet.

Stellt die DependencyProperty dar, die sich auf das Canceling-Ereignis bezieht.

ClosedEvent
Veraltet.

Stellt die DependencyProperty dar, die sich auf das Closed-Ereignis bezieht.

CompensatingEvent
Veraltet.

Stellt die DependencyProperty dar, die sich auf das Compensating-Ereignis bezieht.

ExecutingEvent
Veraltet.

Stellt die DependencyProperty dar, die sich auf das Executing-Ereignis bezieht, das beim Ausführen der Aktivität eintritt.

FaultingEvent
Veraltet.

Die DependencyProperty, die das Faulting-Ereignis darstellt.

StatusChangedEvent
Veraltet.

Stellt die DependencyProperty dar, die sich auf das StatusChanged-Ereignis bezieht.

Eigenschaften

Description
Veraltet.

Ruft die benutzerdefinierte Beschreibung von Activity ab oder legt sie fest.

DesignMode
Veraltet.

Ruft den Wert ab, der angibt, ob sich diese Instanz im Entwurfs- oder Laufzeitmodus befindet.

(Geerbt von DependencyObject)
Enabled
Veraltet.

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob diese Instanz zur Ausführung und Validierung aktiviert ist.

ExecutionResult
Veraltet.

Ruft das ActivityExecutionResult des letzten Versuchs zur Ausführung dieser Instanz ab.

ExecutionStatus
Veraltet.

Ruft den aktuellen ActivityExecutionStatus dieser Instanz ab.

IsDynamicActivity
Veraltet.

Ruft Informationen dazu ab, ob die Aktivität innerhalb des standardmäßigen ActivityExecutionContext der Workflowinstanz ausgeführt wird.

Name
Veraltet.

Ruft den Namen dieser Instanz ab oder legt diesen fest. Dieser Name muss die Namenskonventionen für Variablen der Programmiersprache einhalten, die im Workflowprojekt verwendet wird.

Parent
Veraltet.

Ruft die CompositeActivity ab, die Activity enthält.

ParentDependencyObject
Veraltet.

Ruft das übergeordnete DependencyObject im DependencyObject-Diagramm ab.

(Geerbt von DependencyObject)
QualifiedName
Veraltet.

Ruft den qualifizierten Namen der Aktivität ab. Qualifizierte Aktivitätsnamen sind in einer Workflowinstanz immer eindeutig.

Site
Veraltet.

Ruft einen Verweis auf die Site-Komponente von DependencyObject ab oder legt diesen fest.

(Geerbt von DependencyObject)
UserData
Veraltet.

Ruft ein IDictionary ab, das dieser Klasseninstanz benutzerdefinierte Daten zuordnet.

(Geerbt von DependencyObject)
WorkflowInstanceId
Veraltet.

Ruft die Guid ab, die der Instanz zugeordnet ist.

Methoden

AddHandler(DependencyProperty, Object)
Veraltet.

Fügt einen Handler für ein Ereignis von DependencyObject hinzu.

(Geerbt von DependencyObject)
Cancel(ActivityExecutionContext)
Veraltet.

Wird von der Workflowlaufzeit aufgerufen, um die momentane Ausführung einer Aktivität abzubrechen.

Clone()
Veraltet.

Erstellt eine tiefe Kopie von Activity.

Dispose()
Veraltet.

Gibt alle von DependencyObject verwendeten Ressourcen frei.

(Geerbt von DependencyObject)
Dispose(Boolean)
Veraltet.

Gibt die von DependencyObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von DependencyObject)
Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Execute(ActivityExecutionContext)
Veraltet.

Wird von der Workflowlaufzeit zum Ausführen einer Aktivität aufgerufen.

GetActivityByName(String)
Veraltet.

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. h. innerhalb des Workflows.

GetActivityByName(String, Boolean)
Veraltet.

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.

GetBinding(DependencyProperty)
Veraltet.

Ermöglicht Zugriff auf die ActivityBind, die der bestimmten DependencyProperty zugeordnet ist.

(Geerbt von DependencyObject)
GetBoundValue(ActivityBind, Type)
Veraltet.

Ruft das Object ab, das der Gegenstand von ActivityBind ist.

(Geerbt von DependencyObject)
GetHashCode()
Veraltet.

Fungiert als Standardhashfunktion.

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

Ruft ein Array ab, das die Delegaten für die angegebene DependencyProperty enthält.

(Geerbt von DependencyObject)
GetType()
Veraltet.

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)
Veraltet.

Stellt Zugriff auf den Wert der festgelegten DependencyProperty bereit.

(Geerbt von DependencyObject)
GetValueBase(DependencyProperty)
Veraltet.

Ermöglicht Zugriff auf das gebundene Objekt einer DependencyProperty und umgeht die GetValue(DependencyProperty)-Überschreibung.

(Geerbt von DependencyObject)
HandleFault(ActivityExecutionContext, Exception)
Veraltet.

Wird aufgerufen, wenn eine Ausnahme innerhalb des Kontexts der Ausführung dieser Instanz ausgelöst wird.

Initialize(IServiceProvider)
Veraltet.

Wird von der Workflowlaufzeit aufgerufen, um eine Aktivität während der Erstellung einer neuen Workflowinstanz zu initialisieren. Diese Methode wird während der Erstellung eines dynamischen ActivityExecutionContext aufgerufen.

InitializeProperties()
Veraltet.

Führt Initialisierung von Abhängigkeitseigenschaften aus, wenn eine Überschreibung in einer abgeleiteten Klasse stattfindet.

(Geerbt von DependencyObject)
Invoke<T>(EventHandler<T>, T)
Veraltet.

Abonniert EventHandler und ruft diesen Delegaten auf.

Invoke<T>(IActivityEventListener<T>, T)
Veraltet.

Abonniert IActivityEventListener<T> und ruft diesen Delegaten auf.

IsBindingSet(DependencyProperty)
Veraltet.

Gibt an, ob der Wert einer DependencyProperty als Bindung festgelegt ist. Siehe SetBinding(DependencyProperty, ActivityBind).

(Geerbt von DependencyObject)
Load(Stream, Activity)
Veraltet.

Lädt eine Instanz von Activity von Stream.

Load(Stream, Activity, IFormatter)
Veraltet.

Lädt eine Instanz von Activity mithilfe des benutzerdefinierten Stream für Deserialisierung von IFormatter.

MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MetaEquals(DependencyObject)
Veraltet.

Bestimmt, ob metaproperties dieses DependencyObject den metaproperties des parametrisierten DependencyObject entspricht.

(Geerbt von DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)
Veraltet.

Wird bei jedem Laden von ActivityExecutionContext von der Workflowlaufzeit aufgerufen. 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.

OnActivityExecutionContextUnload(IServiceProvider)
Veraltet.

Wird bei jedem Entladen von ActivityExecutionContext von der Workflowlaufzeit aufgerufen. Beispielsweise wird diese Methode beim Beenden von ActivityExecutionContext sowie bei jedem Entladen von ActivityExecutionContext aufgerufen, wenn eine Workflowinstanz beibehalten wird.

OnClosed(IServiceProvider)
Veraltet.

Wird von der Workflowlaufzeit als Teil des Übergangs der Aktivität in den Zustand Geschlossen aufgerufen.

RaiseEvent(DependencyProperty, Object, EventArgs)
Veraltet.

Löst eine der angegebenen Abhängigkeitseigenschaft zugeordnete Event aus.

RaiseGenericEvent<T>(DependencyProperty, Object, T)
Veraltet.

Löst das Ereignis aus, das der DependencyProperty zugeordnet ist, auf die verwiesen wird.

RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)
Veraltet.

Registriert die angegebene DependencyProperty für das Statusänderungsereignis.

RemoveHandler(DependencyProperty, Object)
Veraltet.

Entfernt einen EventHandler aus einer zugeordneten DependencyProperty.

(Geerbt von DependencyObject)
RemoveProperty(DependencyProperty)
Veraltet.

Entfernt DependencyProperty aus DependencyObject.

(Geerbt von DependencyObject)
Save(Stream)
Veraltet.

Schreibt Activity dauerhaft in Stream.

Save(Stream, IFormatter)
Veraltet.

Schreibt Activity mithilfe des benutzerdefinierten Stream für Serialisierung dauerhaft in IFormatter.

SetBinding(DependencyProperty, ActivityBind)
Veraltet.

Legt die ActivityBind für die angegebene DependencyProperty fest.

(Geerbt von DependencyObject)
SetBoundValue(ActivityBind, Object)
Veraltet.

Legt den Wert der Ziel-ActivityBind fest.

(Geerbt von DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)
Veraltet.

Legt den Wert einer DependencyProperty fest, die schreibgeschützt ist.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)
Veraltet.

Legt den Wert von DependencyProperty für das Objekt fest.

(Geerbt von DependencyObject)
SetValueBase(DependencyProperty, Object)
Veraltet.

Legt den Wert von DependencyProperty auf das angegebene Object fest, wobei SetValue(DependencyProperty, Object) umgangen wird.

(Geerbt von DependencyObject)
ToString()
Veraltet.

Stellt eine Zeichenfolge bereit, die diese Instanz darstellt.

TrackData(Object)
Veraltet.

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.

TrackData(String, Object)
Veraltet.

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.

Uninitialize(IServiceProvider)
Veraltet.

Ermöglicht beim Überschreiben in einer abgeleiteten Klasse das Aufheben der Initialisierung durch einen Dienstanbieter für die Aktivität.

UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)
Veraltet.

Hebt die Registrierung der angegebenen DependencyProperty für das Statusänderungsereignis auf.

Ereignisse

Canceling
Veraltet.

Tritt auf, wenn die Aktivitätsausführung abgebrochen wird.

Closed
Veraltet.

Tritt ein, wenn die Ausführung von Activity abgeschlossen wurde.

Compensating
Veraltet.

Tritt beim Ausführen einer Kompensierungsmethode in Activity auf.

Executing
Veraltet.

Tritt bei Ausführung von Activity ein.

Faulting
Veraltet.

Tritt auf, wenn eine Ausnahme während des Ausführens der Instanz ausgelöst wird.

StatusChanged
Veraltet.

Tritt auf, wenn sich der ActivityExecutionStatus einer ausgeführten Activity ändert.

Explizite Schnittstellenimplementierungen

IComponent.Disposed
Veraltet.

Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt.

(Geerbt von DependencyObject)

Gilt für: