Activity Classe

Definizione

Spazio dei nomi:

System.Workflow.ComponentModel

Assembly:

System.Workflow.ComponentModel.dll

Attenzione

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

Rappresenta il componente di base fondamentale dei flussi di lavoro. Activity è la classe di base per tutte le attività.

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

Ereditarietà

Object

DependencyObject

Activity

Derivato

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

Attributi

ToolboxBitmapAttribute ActivityCodeGeneratorAttribute ActivityValidatorAttribute RuntimeNamePropertyAttribute ObsoleteAttribute

Esempio

In questo esempio viene definita un'attività il cui scopo è inviare un messaggio di posta elettronica. L'attività definisce una proprietà, Subject, che nella relativa implementazione utilizza una proprietà di dipendenza. Le altre proprietà possono essere definite in modo analogo. Viene eseguito l'override del metodo Execute per fornire la logica per l'invio del messaggio di posta elettronica. Per un esempio completo, vedere l'esempio di attività Send 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;  
    }  
}  

Commenti

Nota

In questo materiale vengono descritti tipi e spazi dei nomi obsoleti. Per altre informazioni, vedere Deprecated Types in Windows Workflow Foundation 4.5 (Tipi deprecati in Windows Workflow Foundation 4.5).

Activity rappresenta il componente di base fondamentale dei flussi di lavoro. Un oggetto Activity definisce un set di proprietà ed eventi, ad esempio classi, insieme alla logica di esecuzione che definisce il comportamento di runtime dell'attività. Un set di componenti aggiuntivi può essere associato a un oggetto Activity. Tali componenti includono, in via esemplificativa, un validator, un generatore di codice, serializzatori personalizzati e una finestra di progettazione.

Tutte le attività condividono un set comune di proprietà definito secondo la classe di base Activity. Attraverso l'estensione di questa classe, ogni oggetto Activity può dichiarare proprietà aggiuntive corrispondenti in base alle necessità. Poiché Activity deriva da DependencyObject, le proprietà possono essere definite come proprietà CLR standard e come proprietà di dipendenza.

La logica di esecuzione di una classe Activity adempie a un contratto che esiste tra qualsiasi Activity e il runtime del flusso di lavoro. È necessario documentare la logica di esecuzione di Activity secondo un principio di funzionalità, per cui uno sviluppatore di flussi di lavoro che utilizza Activity ne conoscerà il comportamento. La stessa logica di esecuzione rimane nascosta allo sviluppatore che include l'attività in un flusso di lavoro poiché tale logica è contenuta in un contratto che esiste esclusivamente tra il runtime del flusso di lavoro e Activity.

Costruttori

Activity()	Obsoleti. Inizializza una nuova istanza della classe Activity.
Activity(String)	Obsoleti. Inizializza una nuova istanza della classe Activity durante l’inizializzazione della proprietà Name.

Campi

ActivityContextGuidProperty	Obsoleti. Oggetto DependencyProperty che rappresenta l'oggetto Guid dell'oggetto ActivityExecutionContext associato a Activity.
CancelingEvent	Obsoleti. Rappresenta la classe DependencyProperty che fa riferimento all'evento Canceling.
ClosedEvent	Obsoleti. Rappresenta la classe DependencyProperty che fa riferimento all'evento Closed.
CompensatingEvent	Obsoleti. Rappresenta la classe DependencyProperty che fa riferimento all'evento Compensating.
ExecutingEvent	Obsoleti. Rappresenta la proprietà DependencyProperty che fa riferimento all'evento Executing. Tale evento si verifica quando viene eseguita l'attività.
FaultingEvent	Obsoleti. Oggetto DependencyProperty che rappresenta l'evento Faulting.
StatusChangedEvent	Obsoleti. Rappresenta la classe DependencyProperty che fa riferimento all'evento StatusChanged.

Proprietà

Description	Obsoleti. Ottiene o imposta la descrizione definita dall'utente dell'oggetto Activity.
DesignMode	Obsoleti. Ottiene il valore che indica se l’istanza è in modalità di progettazione o esecuzione. (Ereditato da DependencyObject)
Enabled	Obsoleti. Ottiene o imposta un valore che indica se l'istanza è abilitata per l'esecuzione e la convalida.
ExecutionResult	Obsoleti. Ottiene l’enumerazione ActivityExecutionResult dell’ultimo tentativo di esecuzione dell’istanza.
ExecutionStatus	Obsoleti. Ottiene lo stato corrente ActivityExecutionStatus dell’istanza.
IsDynamicActivity	Obsoleti. Ottiene informazioni che indicano se l'attività è in esecuzione o meno all'interno dell'oggetto ActivityExecutionContext predefinito dell'istanza del flusso di lavoro.
Name	Obsoleti. Ottiene o imposta il nome dell'istanza. Questo nome deve essere conforme alle convenzioni di denominazione delle variabili per il linguaggio di programmazione che si sta utilizzando nel progetto di flusso di lavoro.
Parent	Obsoleti. Ottiene l'oggetto CompositeActivity che contiene questo Activity.
ParentDependencyObject	Obsoleti. Ottiene l’oggetto DependencyObject padre nel grafico di DependencyObject. (Ereditato da DependencyObject)
QualifiedName	Obsoleti. Ottiene il nome completo dell’attività. In un'istanza del flusso di lavoro, i nomi completi di attività sono sempre univoci.
Site	Obsoleti. Ottiene o imposta un riferimento al componente Site di DependencyObject. (Ereditato da DependencyObject)
UserData	Obsoleti. Ottiene un’interfaccia IDictionary che associa dati personalizzati a questa istanza della classe. (Ereditato da DependencyObject)
WorkflowInstanceId	Obsoleti. Ottiene l’identificativo Guid associato all’istanza.

Metodi

AddHandler(DependencyProperty, Object)	Obsoleti. Aggiunge un gestore per un evento di una classe DependencyObject. (Ereditato da DependencyObject)
Cancel(ActivityExecutionContext)	Obsoleti. Chiamata dal runtime del flusso di lavoro per annullare l’esecuzione di un'attività attualmente in esecuzione.
Clone()	Obsoleti. Crea una copia completa della classe Activity.
Dispose()	Obsoleti. Libera tutte le risorse utilizzate dall'oggetto DependencyObject. (Ereditato da DependencyObject)
Dispose(Boolean)	Obsoleti. Libera le risorse non gestite utilizzate dall’oggetto DependencyObject ed eventualmente le risorse gestite. (Ereditato da DependencyObject)
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Execute(ActivityExecutionContext)	Obsoleti. Chiamato dal runtime del flusso di lavoro per eseguire un'attività.
GetActivityByName(String)	Obsoleti. Restituisce l'istanza dell'oggetto Activity, il cui nome viene richiesto dal set di tutte le attività in esecuzione nell'attività radice di questa istanza che si trova all'interno del flusso di lavoro.
GetActivityByName(String, Boolean)	Obsoleti. Restituisce l’istanza di Activity il cui nome viene richiesto dal set di tutte le attività sotto la classe radice Activity di questa istanza, se il secondo parametro è false e sotto la classe Activity corrente se il secondo parametro è true.
GetBinding(DependencyProperty)	Obsoleti. Fornisce l’accesso alla classe ActivityBind associata alla classe DependencyProperty specifica. (Ereditato da DependencyObject)
GetBoundValue(ActivityBind, Type)	Obsoleti. Recupera l'oggetto Object che corrisponde al soggetto di una classe ActivityBind. (Ereditato da DependencyObject)
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetInvocationList<T>(DependencyProperty)	Obsoleti. Ottiene una matrice che contiene i delegati per la classe DependencyProperty specificata. (Ereditato da DependencyObject)
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Obsoleti. Fornisce l’accesso al valore della classe DependencyProperty designata. (Ereditato da DependencyObject)
GetValueBase(DependencyProperty)	Obsoleti. Fornisce l’accesso all’oggetto associato di una classe DependencyProperty, ignorando l’override di GetValue(DependencyProperty). (Ereditato da DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	Obsoleti. Chiamato quando all'interno del contesto di esecuzione di questa istanza viene generata un'eccezione.
Initialize(IServiceProvider)	Obsoleti. Chiamata dal runtime del flusso di lavoro per inizializzare un'attività durante la costruzione di una nuova istanza del flusso di lavoro. Il metodo viene chiamato durante la costruzione di un ActivityExecutionContext dinamico.
InitializeProperties()	Obsoleti. Esegue l’inizializzazione sulle proprietà di dipendenza quando ne viene eseguito l’override in una classe derivata. (Ereditato da DependencyObject)
Invoke<T>(EventHandler<T>, T)	Obsoleti. Sottoscrive un EventHandler e richiama il delegato.
Invoke<T>(IActivityEventListener<T>, T)	Obsoleti. Sottoscrive un IActivityEventListener<T> e richiama il delegato.
IsBindingSet(DependencyProperty)	Obsoleti. Indica se il valore di DependencyProperty è impostato come un'associazione. Vedere SetBinding(DependencyProperty, ActivityBind). (Ereditato da DependencyObject)
Load(Stream, Activity)	Obsoleti. Carica un'istanza di una classe Activity da una classe Stream.
Load(Stream, Activity, IFormatter)	Obsoleti. Carica un'istanza della classe Activity da una classe Stream utilizzando l’interfaccia personalizzata IFormatter per la deserializzazione.
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MetaEquals(DependencyObject)	Obsoleti. Determina se le metaproperties di DependencyObject sono uguali alle metaproperties della classe DependencyObject parametrizzata. (Ereditato da DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	Obsoleti. Chiamato dal runtime del flusso di lavoro quando viene caricato il contesto ActivityExecutionContext. Ad esempio, questo metodo viene chiamato sia durante la creazione di un ActivityExecutionContext sia ogni volta che ActivityExecutionContext viene ricreato al momento di caricare un’istanza del flusso di lavoro da un’archiviazione persistente.
OnActivityExecutionContextUnload(IServiceProvider)	Obsoleti. Chiamato dal runtime del flusso di lavoro quando viene scaricato il contesto ActivityExecutionContext. Ad esempio, questo metodo viene chiamato sia durante il completamento di un ActivityExecutionContext sia ogni volta che ActivityExecutionContext viene scaricato al momento di rendere persistente un’istanza del flusso di lavoro.
OnClosed(IServiceProvider)	Obsoleti. Chiamato dal motore di runtime del flusso di lavoro come parte della transizione dell'attività allo stato chiuso.
RaiseEvent(DependencyProperty, Object, EventArgs)	Obsoleti. Genera un evento Event associato alla proprietà di dipendenza specificata.
RaiseGenericEvent<T>(DependencyProperty, Object, T)	Obsoleti. Genera l’evento associato alla proprietà DependencyProperty a cui si fa riferimento.
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleti. Registra la proprietà specificata DependencyProperty relativamente all’evento di modifica dello stato.
RemoveHandler(DependencyProperty, Object)	Obsoleti. Rimuove un elemento EventHandler dalla classe DependencyProperty associata. (Ereditato da DependencyObject)
RemoveProperty(DependencyProperty)	Obsoleti. Rimuove una classe DependencyProperty dalla classe DependencyObject. (Ereditato da DependencyObject)
Save(Stream)	Obsoleti. Scrive la classe Activity in una classe Stream per la persistenza.
Save(Stream, IFormatter)	Obsoleti. Scrive Activity in una classe Stream per la persistenza utilizzando l’interfaccia IFormatter personalizzata fornita per la serializzazione.
SetBinding(DependencyProperty, ActivityBind)	Obsoleti. Imposta ActivityBind per la classe DependencyProperty specificata. (Ereditato da DependencyObject)
SetBoundValue(ActivityBind, Object)	Obsoleti. Imposta il valore della classe ActivityBind di destinazione. (Ereditato da DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	Obsoleti. Imposta il valore di DependencyProperty in sola lettura. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Obsoleti. Imposta il valore di DependencyProperty sull’oggetto. (Ereditato da DependencyObject)
SetValueBase(DependencyProperty, Object)	Obsoleti. Imposta il valore della classe DependencyProperty all’oggetto Object specificato, ignorando SetValue(DependencyProperty, Object). (Ereditato da DependencyObject)
ToString()	Obsoleti. Fornisce una stringa che rappresenta l'istanza.
TrackData(Object)	Obsoleti. Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso.
TrackData(String, Object)	Obsoleti. Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso.
Uninitialize(IServiceProvider)	Obsoleti. Quando viene eseguito l'override in una classe derivata, fornisce la non inizializzazione mediante un provider di servizi per l'attività.
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleti. Annulla la registrazione della proprietà specificata DependencyProperty per l’evento di modifica dello stato.

Eventi

Canceling	Obsoleti. Si verifica quando l'esecuzione dell’attività è annullata.
Closed	Obsoleti. Si verifica quando viene completata l'esecuzione di Activity.
Compensating	Obsoleti. Si verifica in caso dell'esecuzione di un metodo di compensazione su Activity.
Executing	Obsoleti. Si verifica quando viene eseguita la classe Activity.
Faulting	Obsoleti. Si verifica quando viene generata un'eccezione durante l’esecuzione dell'istanza.
StatusChanged	Obsoleti. Si verifica quando viene modificato lo stato ActivityExecutionStatus di una classe Activity in esecuzione.

Implementazioni dell'interfaccia esplicita

IComponent.Disposed

Obsoleti. Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da DependencyObject)