Activity Class

Definition

Warning

This API is now obsolete.

Rappresenta il componente di base fondamentale dei flussi di lavoro.Represents the fundamental building block of workflows. Activity è la classe di base per tutte le attività.Activity is the base class for all activities.

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.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
[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
type Activity = class
    inherit DependencyObject
Public Class Activity
Inherits DependencyObject
Inheritance
Derived
Attributes

Examples

In questo esempio viene definita un'attività il cui scopo è inviare un messaggio di posta elettronica.This example defines an activity whose purpose is to send an email. L'attività definisce una proprietà, Subject, che nella relativa implementazione utilizza una proprietà di dipendenza.The activity defines one property, Subject, that uses a dependency property in its implementation. Le altre proprietà possono essere definite in modo analogo.Other properties can be defined in a similar way. Viene eseguito l'override del metodo Execute per fornire la logica per l'invio del messaggio di posta elettronica.The Execute method is overridden to provide the logic for sending the email. Per un esempio completo, vedere l' esempio relativo all'attività Invia messaggio di posta elettronica.For a complete example, see the Send Email Activity Sample.

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

Remarks

Note

In questo materiale vengono descritti tipi e spazi dei nomi obsoleti.This material discusses types and namespaces that are obsolete. Per altre informazioni, vedere Deprecated Types in Windows Workflow Foundation 4.5 (Tipi deprecati in Windows Workflow Foundation 4.5).For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Activity rappresenta il componente di base fondamentale dei flussi di lavoro.An Activity is the fundamental building block of workflows. 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à.An Activity defines a set of properties and events, such as any class, along with execution logic that defines the activity's run-time behavior. Un set di componenti aggiuntivi può essere associato a un oggetto Activity.A set of additional components can be associated with an Activity. Tali componenti includono, in via esemplificativa, un validator, un generatore di codice, serializzatori personalizzati e una finestra di progettazione.These include, but are not limited to a validator, a code generator, custom serializers, and a designer.

Tutte le attività condividono un set comune di proprietà definito secondo la classe di base Activity.All activities share a common set of properties defined on the Activity base class. Attraverso l'estensione di questa classe, ogni oggetto Activity può dichiarare proprietà aggiuntive corrispondenti in base alle necessità.Each Activity can declare its own additional properties according to its requirements by extending this class. Poiché Activity deriva da DependencyObject, le proprietà possono essere definite come proprietà CLR standard e come proprietà di dipendenza.Because Activity derives from DependencyObject, properties can be defined as standard CLR properties and as dependency properties.

La logica di esecuzione di una classe Activity adempie a un contratto che esiste tra qualsiasi Activity e il runtime del flusso di lavoro.The execution logic of an Activity fulfills a contract that exists between any Activity and the workflow runtime. È 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.You must document the execution logic of any Activity in a functional sense, so that a workflow developer who uses the Activity knows how it behaves. 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.The execution logic itself is hidden from the workflow developer who includes the activity in a workflow, because the execution logic is part of a contract that exists strictly between the workflow runtime and the Activity.

Constructors

Activity()

Inizializza una nuova istanza della classe Activity.Initializes a new instance of the Activity class.

Activity(String)

Inizializza una nuova istanza della classe Activity durante l’inizializzazione della proprietà Name.Initializes a new instance of the Activity class, while initializing the Name.

Fields

ActivityContextGuidProperty

Oggetto DependencyProperty che rappresenta l'oggetto Guid dell'oggetto ActivityExecutionContext associato a Activity.The DependencyProperty that represents the Guid of the ActivityExecutionContext that is associated with the Activity.

CancelingEvent

Rappresenta la classe DependencyProperty che fa riferimento all'evento Canceling.Represents the DependencyProperty that targets the Canceling event.

ClosedEvent

Rappresenta la classe DependencyProperty che fa riferimento all'evento Closed.Represents the DependencyProperty that targets the Closed event.

CompensatingEvent

Rappresenta la classe DependencyProperty che fa riferimento all'evento Compensating.Represents the DependencyProperty that targets the Compensating event.

ExecutingEvent

Rappresenta la proprietà DependencyProperty che fa riferimento all'evento Executing. Tale evento si verifica quando viene eseguita l'attività.Represents the DependencyProperty that targets the Executing event, which occurs when the activity is executed.

FaultingEvent

Oggetto DependencyProperty che rappresenta l'evento Faulting.The DependencyProperty that represents the Faulting event.

StatusChangedEvent

Rappresenta la classe DependencyProperty che fa riferimento all'evento StatusChanged.Represents the DependencyProperty that targets the StatusChanged event.

Properties

Description

Ottiene o imposta la descrizione definita dall'utente dell'oggetto Activity.Gets or sets the user-defined description of the Activity.

DesignMode

Ottiene il valore che indica se l’istanza è in modalità di progettazione o esecuzione.Gets the value that indicates whether this instance is in design or run-time mode.

(Inherited from DependencyObject)
Enabled

Ottiene o imposta un valore che indica se l'istanza è abilitata per l'esecuzione e la convalida.Gets or sets a value that indicates whether this instance is enabled for execution and validation.

ExecutionResult

Ottiene l’enumerazione ActivityExecutionResult dell’ultimo tentativo di esecuzione dell’istanza.Gets the ActivityExecutionResult of the last attempt to run this instance.

ExecutionStatus

Ottiene lo stato corrente ActivityExecutionStatus dell’istanza.Gets the current ActivityExecutionStatus of this instance.

IsDynamicActivity

Ottiene informazioni che indicano se l'attività è in esecuzione o meno all'interno dell'oggetto ActivityExecutionContext predefinito dell'istanza del flusso di lavoro.Gets information about whether the activity is executing within the default ActivityExecutionContext of the workflow instance.

Name

Ottiene o imposta il nome dell'istanza.Gets or sets the name of this instance. 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.This name must conform to the variable naming convention of the programming language that is being used in the Workflow project.

Parent

Ottiene l'oggetto CompositeActivity che contiene questo Activity.Gets the CompositeActivity that contains this Activity.

ParentDependencyObject

Ottiene l’oggetto DependencyObject padre nel grafico di DependencyObject.Gets the parent DependencyObject in the DependencyObject graph.

(Inherited from DependencyObject)
QualifiedName

Ottiene il nome completo dell’attività.Gets the qualified name of the activity. In un'istanza del flusso di lavoro, i nomi completi di attività sono sempre univoci.Qualified activity names are always unique in a workflow instance.

Site

Ottiene o imposta un riferimento al componente Site di DependencyObject.Gets or sets a reference to the Site component of the DependencyObject.

(Inherited from DependencyObject)
UserData

Ottiene un’interfaccia IDictionary che associa dati personalizzati a questa istanza della classe.Gets an IDictionary that associates custom data with this class instance.

(Inherited from DependencyObject)
WorkflowInstanceId

Ottiene l’identificativo Guid associato all’istanza.Gets the Guid associated with the instance.

Methods

AddHandler(DependencyProperty, Object)

Aggiunge un gestore per un evento di una classe DependencyObject.Adds a handler for an event of a DependencyObject.

(Inherited from DependencyObject)
Cancel(ActivityExecutionContext)

Chiamata dal runtime del flusso di lavoro per annullare l’esecuzione di un'attività attualmente in esecuzione.Called by the workflow runtime to cancel execution of an activity that is currently executing.

Clone()

Crea una copia completa della classe Activity.Creates a deep copy of the Activity.

Dispose()

Libera tutte le risorse utilizzate dall'oggetto DependencyObject.Releases all the resources used by the DependencyObject.

(Inherited from DependencyObject)
Dispose(Boolean)

Libera le risorse non gestite utilizzate dall’oggetto DependencyObject ed eventualmente le risorse gestite.Releases the unmanaged resources and optionally releases the managed resources used by DependencyObject.

(Inherited from DependencyObject)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(ActivityExecutionContext)

Chiamato dal runtime del flusso di lavoro per eseguire un'attività.Called by the workflow runtime to execute an activity.

GetActivityByName(String)

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.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.

GetActivityByName(String, Boolean)

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.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.

GetBinding(DependencyProperty)

Fornisce l’accesso alla classe ActivityBind associata alla classe DependencyProperty specifica.Provides access to the ActivityBind associated with the specific DependencyProperty.

(Inherited from DependencyObject)
GetBoundValue(ActivityBind, Type)

Recupera l'oggetto Object che corrisponde al soggetto di una classe ActivityBind.Retrieves the Object that is the subject of an ActivityBind.

(Inherited from DependencyObject)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetInvocationList<T>(DependencyProperty)

Ottiene una matrice che contiene i delegati per la classe DependencyProperty specificata.Gets an array that contains the delegates for the specified DependencyProperty.

(Inherited from DependencyObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty)

Fornisce l’accesso al valore della classe DependencyProperty designata.Provides access to the value of the designated DependencyProperty.

(Inherited from DependencyObject)
GetValueBase(DependencyProperty)

Fornisce l’accesso all’oggetto associato di una classe DependencyProperty, ignorando l’override di GetValue(DependencyProperty).Provides access to the bound object of a DependencyProperty and bypasses the GetValue(DependencyProperty) override.

(Inherited from DependencyObject)
HandleFault(ActivityExecutionContext, Exception)

Chiamato quando all'interno del contesto di esecuzione di questa istanza viene generata un'eccezione.Called when an exception is raised within the context of the execution of this instance.

Initialize(IServiceProvider)

Chiamata dal runtime del flusso di lavoro per inizializzare un'attività durante la costruzione di una nuova istanza del flusso di lavoro.Called by the workflow runtime to initialize an activity during the construction of a new workflow instance. Il metodo viene chiamato durante la costruzione di un ActivityExecutionContext dinamico.This method is called during the construction of a dynamic ActivityExecutionContext.

InitializeProperties()

Esegue l’inizializzazione sulle proprietà di dipendenza quando ne viene eseguito l’override in una classe derivata.Performs initialization on dependency properties when overridden in a derived class.

(Inherited from DependencyObject)
Invoke<T>(EventHandler<T>, T)

Sottoscrive un EventHandler e richiama il delegato.Subscribes an EventHandler and invokes that delegate.

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

Sottoscrive un IActivityEventListener<T> e richiama il delegato.Subscribes an IActivityEventListener<T> and invokes that delegate.

IsBindingSet(DependencyProperty)

Indica se il valore di DependencyProperty è impostato come un'associazione.Indicates whether the value of a DependencyProperty is set as a binding. Vedere SetBinding(DependencyProperty, ActivityBind).See SetBinding(DependencyProperty, ActivityBind).

(Inherited from DependencyObject)
Load(Stream, Activity)

Carica un'istanza di una classe Activity da una classe Stream.Loads an instance of an Activity from a Stream.

Load(Stream, Activity, IFormatter)

Carica un'istanza della classe Activity da una classe Stream utilizzando l’interfaccia personalizzata IFormatter per la deserializzazione.Loads an instance of an Activity from a Stream using the custom IFormatter for deserialization.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MetaEquals(DependencyObject)

Determina se le metaproperties di DependencyObject sono uguali alle metaproperties della classe DependencyObject parametrizzata.Determines whether the metaproperties of this DependencyObject equals the metaproperties of the parameterized DependencyObject.

(Inherited from DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

Chiamato dal runtime del flusso di lavoro quando viene caricato il contesto ActivityExecutionContext.Called by the workflow runtime whenever an ActivityExecutionContext is loaded. 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.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.

OnActivityExecutionContextUnload(IServiceProvider)

Chiamato dal runtime del flusso di lavoro quando viene scaricato il contesto ActivityExecutionContext.Called by the workflow runtime whenever an ActivityExecutionContext is unloaded. 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.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.

OnClosed(IServiceProvider)

Chiamato dal motore di runtime del flusso di lavoro come parte della transizione dell'attività allo stato chiuso.Called by the workflow runtime as part of the activity's transition to the closed state.

RaiseEvent(DependencyProperty, Object, EventArgs)

Genera un evento Event associato alla proprietà di dipendenza specificata.Raises an Event associated with the specified dependency property.

RaiseGenericEvent<T>(DependencyProperty, Object, T)

Genera l’evento associato alla proprietà DependencyProperty a cui si fa riferimento.Raises the event associated with the referenced DependencyProperty.

RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Registra la proprietà specificata DependencyProperty relativamente all’evento di modifica dello stato.Registers the specified DependencyProperty for the status change event.

RemoveHandler(DependencyProperty, Object)

Rimuove un elemento EventHandler dalla classe DependencyProperty associata.Removes an EventHandler from an associated DependencyProperty.

(Inherited from DependencyObject)
RemoveProperty(DependencyProperty)

Rimuove una classe DependencyProperty dalla classe DependencyObject.Removes a DependencyProperty from the DependencyObject.

(Inherited from DependencyObject)
Save(Stream)

Scrive la classe Activity in una classe Stream per la persistenza.Writes the Activity to a Stream for persistence.

Save(Stream, IFormatter)

Scrive Activity in una classe Stream per la persistenza utilizzando l’interfaccia IFormatter personalizzata fornita per la serializzazione.Writes the Activity to a Stream for persistence using the custom IFormatter provided for serialization.

SetBinding(DependencyProperty, ActivityBind)

Imposta ActivityBind per la classe DependencyProperty specificata.Sets the ActivityBind for the specified DependencyProperty.

(Inherited from DependencyObject)
SetBoundValue(ActivityBind, Object)

Imposta il valore della classe ActivityBind di destinazione.Sets the value of the target ActivityBind.

(Inherited from DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)

Imposta il valore di DependencyProperty in sola lettura.Sets the value of a DependencyProperty, which is read-only.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore di DependencyProperty sull’oggetto.Sets the value of the DependencyProperty to the object.

(Inherited from DependencyObject)
SetValueBase(DependencyProperty, Object)

Imposta il valore della classe DependencyProperty all’oggetto Object specificato, ignorando SetValue(DependencyProperty, Object).Sets the value of the DependencyProperty to the specified Object, bypassing the SetValue(DependencyProperty, Object).

(Inherited from DependencyObject)
ToString()

Fornisce una stringa che rappresenta l'istanza.Provides a string that represents this instance.

TrackData(Object)

Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso.Informs the run-time tracking infrastructure of pending tracking information.

TrackData(String, Object)

Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso.Informs the run-time tracking infrastructure of pending tracking information.

Uninitialize(IServiceProvider)

Quando viene eseguito l'override in una classe derivata, fornisce la non inizializzazione mediante un provider di servizi per l'attività.When overridden in a derived class, provides un-initialization by a service provider for the activity.

UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Annulla la registrazione della proprietà specificata DependencyProperty per l’evento di modifica dello stato.Un-registers the specified DependencyProperty for the status change event.

Events

Canceling

Si verifica quando l'esecuzione dell’attività è annullata.Occurs when the activity execution is canceled.

Closed

Si verifica quando viene completata l'esecuzione di Activity.Occurs when an Activity has completed execution.

Compensating

Si verifica in caso dell'esecuzione di un metodo di compensazione su Activity.Occurs when running a compensation method on the Activity.

Executing

Si verifica quando viene eseguita la classe Activity.Occurs when the Activity is run.

Faulting

Si verifica quando viene generata un'eccezione durante l’esecuzione dell'istanza.Occurs when an exception is raised during the running of the instance.

StatusChanged

Si verifica quando viene modificato lo stato ActivityExecutionStatus di una classe Activity in esecuzione.Occurs when the ActivityExecutionStatus of a running Activity changes.

Explicit Interface Implementations

IComponent.Disposed

Rappresenta il metodo che gestisce l'evento Disposed di un componente.Represents the method that handles the Disposed event of a component.

(Inherited from DependencyObject)

Applies to