Activity Classe

Définition

Espace de noms:

System.Workflow.ComponentModel

Assembly:

System.Workflow.ComponentModel.dll

Attention

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

Représente le bloc de construction fondamental des flux de travail. Activity est la classe de base pour toutes les activités.

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")]
[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")>]
[<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

Héritage

Object

DependencyObject

Activity

Dérivé

System.Workflow.Activities.CallExternalMethodActivity

System.Workflow.Activities.CodeActivity

System.Workflow.Activities.DelayActivity

System.Workflow.Activities.HandleExternalEventActivity

System.Workflow.Activities.InvokeWebServiceActivity

System.Workflow.Activities.InvokeWorkflowActivity

System.Workflow.Activities.PolicyActivity

System.Workflow.Activities.SendActivity

System.Workflow.Activities.SetStateActivity

System.Workflow.Activities.WebServiceFaultActivity

System.Workflow.Activities.WebServiceInputActivity

System.Workflow.Activities.WebServiceOutputActivity

System.Workflow.ComponentModel.CompensateActivity

System.Workflow.ComponentModel.CompositeActivity

System.Workflow.ComponentModel.SuspendActivity

System.Workflow.ComponentModel.TerminateActivity

System.Workflow.ComponentModel.ThrowActivity

Attributs

ToolboxBitmapAttribute ActivityCodeGeneratorAttribute ActivityValidatorAttribute RuntimeNamePropertyAttribute ObsoleteAttribute

Exemples

Cet exemple définit une activité dont le but est d'envoyer un courrier électronique. L'activité définit une seule propriété, Subject, dont l'implémentation utilise une propriété de dépendance. D'autres propriétés peuvent être définies de la même manière. La méthode Execute est substituée pour fournir la logique d'envoi d'un courrier électronique. Pour obtenir un exemple complet, consultez l’exemple d’activité Envoyer Email.

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;  
    }  
}  

Remarques

Notes

Ce document décrit les types et les espaces de noms qui sont obsolètes. Pour plus d’informations, consultez Types dépréciés dans Windows Workflow Foundation 4.5.

Un Activity est le bloc de construction fondamental des workflows. Un Activity définit un ensemble de propriétés et d'événements, comme toutes les classes, mais également une logique d'exécution qui définit le comportement de l'activité au moment de l'exécution. Un jeu de composants additionnels peut être associé à un Activity. Ceux-ci incluent, mais ne sont pas limités à un validateur, un générateur de code, des sérialiseurs personnalisés et un concepteur.

Toutes les activités partagent un ensemble de propriétés défini sur la classe de base Activity. Chaque Activity peut déclarer ses propres propriétés supplémentaires d’après ses besoins en étendant cette classe. Les propriétés peuvent être définies comme propriétés CLR standard et comme propriétés de dépendance car Activity dérive de DependencyObject.

La logique d'exécution d'un Activity répond à un contrat qui existe entre chaque Activity et l'exécution du workflow. Vous devez documenter la logique d'exécution de chaque Activity au sens fonctionnel, afin qu'un développeur de workflow qui utilise Activity sache comment il se comporte. La logique d'exécution en elle-même est masquée du développeur de workflow qui inclut l'activité dans un workflow car elle fait partie d'un contrat qui existe uniquement entre l'exécution du workflow et Activity.

Constructeurs

Activity()	Obsolète. Initialise une nouvelle instance de la classe Activity.
Activity(String)	Obsolète. Initialise une nouvelle instance de la classe Activity, tout en initialisant le Name.

Champs

ActivityContextGuidProperty	Obsolète. DependencyProperty qui représente le Guid du ActivityExecutionContext associé au Activity.
CancelingEvent	Obsolète. Représente le DependencyProperty qui cible l'événement Canceling.
ClosedEvent	Obsolète. Représente le DependencyProperty qui cible l'événement Closed.
CompensatingEvent	Obsolète. Représente le DependencyProperty qui cible l'événement Compensating.
ExecutingEvent	Obsolète. Représente le DependencyProperty qui cible l'événement Executing, qui se produit lorsque l'activité est exécutée.
FaultingEvent	Obsolète. DependencyProperty qui représente l'événement Faulting.
StatusChangedEvent	Obsolète. Représente le DependencyProperty qui cible l'événement StatusChanged.

Propriétés

Description	Obsolète. Obtient ou définit la description définie par l'utilisateur du Activity.
DesignMode	Obsolète. Obtient la valeur qui indique si cette instance est en mode Création ou Exécution. (Hérité de DependencyObject)
Enabled	Obsolète. Obtient ou définit une valeur qui indique si cette instance est activée pour l’exécution et la validation.
ExecutionResult	Obsolète. Obtient le ActivityExecutionResult de la dernière tentative d'exécution de cette instance.
ExecutionStatus	Obsolète. Obtient le ActivityExecutionStatus actuel de cette instance.
IsDynamicActivity	Obsolète. Obtient des informations sur l'exécution de l'activité dans le ActivityExecutionContext par défaut de l'instance de workflow.
Name	Obsolète. Obtient ou définit le nom de cette instance. Ce nom doit se conformer à la convention d'affectation des noms variables du langage de programmation utilisé dans le projet de workflow.
Parent	Obsolète. Obtient le CompositeActivity qui contient ce Activity.
ParentDependencyObject	Obsolète. Obtient le DependencyObject parent dans le graphique DependencyObject. (Hérité de DependencyObject)
QualifiedName	Obsolète. Obtient le nom qualifié de l'activité. Les noms qualifiés d'activité sont toujours uniques dans une instance de workflow.
Site	Obsolète. Obtient ou définit une référence au composant Site de DependencyObject. (Hérité de DependencyObject)
UserData	Obsolète. Obtient un IDictionary qui associe des données personnalisées à cette instance de classe. (Hérité de DependencyObject)
WorkflowInstanceId	Obsolète. Obtient le Guid associé à l'instance.

Méthodes

AddHandler(DependencyProperty, Object)	Obsolète. Ajoute un gestionnaire pour un événement d'un DependencyObject. (Hérité de DependencyObject)
Cancel(ActivityExecutionContext)	Obsolète. Appelé par l'exécution du workflow pour annuler celle d'une activité en cours.
Clone()	Obsolète. Crée une copie complète de Activity.
Dispose()	Obsolète. Libère toutes les ressources utilisées par DependencyObject. (Hérité de DependencyObject)
Dispose(Boolean)	Obsolète. Libère les ressources non managées et éventuellement les ressources managées utilisées par DependencyObject. (Hérité de DependencyObject)
Equals(Object)	Obsolète. Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Execute(ActivityExecutionContext)	Obsolète. Appelé par l'exécution du workflow pour exécuter une activité.
GetActivityByName(String)	Obsolète. Retourne l'instance du Activity dont le nom est demandé à l'ensemble des activités s'exécutant sous l'activité racine de cette instance, c'est-à-dire au sein du workflow.
GetActivityByName(String, Boolean)	Obsolète. Retourne l'instance du Activity dont le nom est demandé à l'ensemble des activités sous la racine du Activity de cette instance si le deuxième paramètre est false et sous le Activity actuel si le deuxième paramètre est true.
GetBinding(DependencyProperty)	Obsolète. Fournit l'accès au ActivityBind associé au DependencyProperty spécifique. (Hérité de DependencyObject)
GetBoundValue(ActivityBind, Type)	Obsolète. Récupère le Object qui est le sujet d'un ActivityBind. (Hérité de DependencyObject)
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (Hérité de Object)
GetInvocationList<T>(DependencyProperty)	Obsolète. Obtient un tableau qui contient les délégués du DependencyProperty spécifié. (Hérité de DependencyObject)
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Obsolète. Fournit l'accès à la valeur du DependencyProperty désigné. (Hérité de DependencyObject)
GetValueBase(DependencyProperty)	Obsolète. Fournit l'accès à l'objet lié d'un objet DependencyProperty et contourne la substitution GetValue(DependencyProperty). (Hérité de DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	Obsolète. Appelée lorsqu'une exception est levée dans le contexte de l'exécution de cette instance.
Initialize(IServiceProvider)	Obsolète. Appelé par l'exécution du workflow pour initialiser une activité pendant la construction d'une nouvelle instance de workflow. Cette méthode est appelée pendant la construction d'un ActivityExecutionContext dynamique.
InitializeProperties()	Obsolète. Exécute l'initialisation des propriétés de dépendance en cas de substitution dans une classe dérivée. (Hérité de DependencyObject)
Invoke<T>(EventHandler<T>, T)	Obsolète. Souscrit un EventHandler et appelle ce délégué.
Invoke<T>(IActivityEventListener<T>, T)	Obsolète. Souscrit un IActivityEventListener<T> et appelle ce délégué.
IsBindingSet(DependencyProperty)	Obsolète. Indique si la valeur d'un objet DependencyProperty est définie comme liaison. Consultez SetBinding(DependencyProperty, ActivityBind). (Hérité de DependencyObject)
Load(Stream, Activity)	Obsolète. Charge une instance d'un Activity à partir d'un Stream.
Load(Stream, Activity, IFormatter)	Obsolète. Charge une instance d’un Activity à partir d’un Stream à l’aide du IFormatter personnalisé pour la désérialisation.
MemberwiseClone()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
MetaEquals(DependencyObject)	Obsolète. Détermine si le metaproperties de ce DependencyObject est égal au metaproperties du DependencyObject paramétré. (Hérité de DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	Obsolète. Appelé par l'exécution du workflow chaque fois qu'un ActivityExecutionContext est chargé. Par exemple, cette méthode est appelée pendant la création d'un ActivityExecutionContext, ainsi que chaque fois que ActivityExecutionContext est réincarné lorsqu'une instance de workflow est chargée à partir d'un stockage persistant.
OnActivityExecutionContextUnload(IServiceProvider)	Obsolète. Appelé par l'exécution du workflow chaque fois qu'un ActivityExecutionContext est déchargé. Par exemple, cette méthode est appelée à la fin d'un ActivityExecutionContext, ainsi que chaque fois que ActivityExecutionContext est déchargé lorsqu'une instance de workflow est rendue persistante.
OnClosed(IServiceProvider)	Obsolète. Appelé par l'exécution du workflow dans le cadre du passage de l'activité à l'état Fermé.
RaiseEvent(DependencyProperty, Object, EventArgs)	Obsolète. Déclenche un Event associé à la propriété de dépendance spécifiée.
RaiseGenericEvent<T>(DependencyProperty, Object, T)	Obsolète. Déclenche l'événement associé au DependencyProperty référencé.
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsolète. Inscrit le DependencyProperty spécifié pour l'événement de modification de l'état.
RemoveHandler(DependencyProperty, Object)	Obsolète. Supprime un EventHandler d'un DependencyProperty associé. (Hérité de DependencyObject)
RemoveProperty(DependencyProperty)	Obsolète. Supprime un DependencyProperty de DependencyObject. (Hérité de DependencyObject)
Save(Stream)	Obsolète. Écrit le Activity sur un Stream pour la persistence.
Save(Stream, IFormatter)	Obsolète. Écrit le Activity sur un Stream pour la persistance à l'aide du IFormatter personnalisé fourni pour la sérialisation.
SetBinding(DependencyProperty, ActivityBind)	Obsolète. Définit le ActivityBind du DependencyProperty spécifié. (Hérité de DependencyObject)
SetBoundValue(ActivityBind, Object)	Obsolète. Définit la valeur du ActivityBind cible. (Hérité de DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	Obsolète. Définit la valeur d'un objet DependencyProperty, qui est en lecture seule. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Obsolète. Attribue la valeur DependencyProperty à l'objet. (Hérité de DependencyObject)
SetValueBase(DependencyProperty, Object)	Obsolète. Attribue la valeur de DependencyProperty au Object spécifié, en ignorant SetValue(DependencyProperty, Object). (Hérité de DependencyObject)
ToString()	Obsolète. Fournit une chaîne représentant cette instance.
TrackData(Object)	Obsolète. Informe l'infrastructure de suivi de l'exécution d'informations de suivi en attente.
TrackData(String, Object)	Obsolète. Informe l'infrastructure de suivi de l'exécution d'informations de suivi en attente.
Uninitialize(IServiceProvider)	Obsolète. En cas de substitution dans une classe dérivée, fournit une désinitialisation par un fournisseur de services pour l'activité.
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsolète. Désinscrit le DependencyProperty spécifié pour l'événement de modification de l'état.

Événements

Canceling	Obsolète. Se produit lorsque l'exécution de l'activité est annulée.
Closed	Obsolète. Se produit lorsque l'exécution d'un Activity est terminée.
Compensating	Obsolète. Se produit lors de l'exécution d'une méthode de compensation sur Activity.
Executing	Obsolète. Se produit lors de l'exécution de Activity.
Faulting	Obsolète. Se produit lorsqu'une exception est déclenchée durant l'exécution de l'instance.
StatusChanged	Obsolète. Se produit lors de la modification du ActivityExecutionStatus d'un Activity en cours d'exécution.

Implémentations d’interfaces explicites

IComponent.Disposed

Obsolète. Représente la méthode qui gère l’événement Disposed d’un composant. (Hérité de DependencyObject)