Activity Classe

Definição

Namespace:

System.Workflow.ComponentModel

Assembly:

System.Workflow.ComponentModel.dll

Cuidado

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

Representa o bloco de construção fundamental dos fluxos de trabalho. Activity é a classe base para todas as atividades.

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

Herança

Object

DependencyObject

Activity

Derivado

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

Atributos

ToolboxBitmapAttribute ActivityCodeGeneratorAttribute ActivityValidatorAttribute RuntimeNamePropertyAttribute ObsoleteAttribute

Exemplos

Este exemplo define uma atividade cuja finalidade é enviar um email. A atividade define uma propriedade, Subject, que usa uma propriedade de dependência em sua implementação. Outras propriedades podem ser definidas de maneira semelhante. O Execute método é substituído para fornecer a lógica para enviar o email. Para obter um exemplo completo, consulte Enviar Email Exemplo de Atividade.

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

Comentários

Observação

Este material discute tipos e namespaces obsoletos. Para obter mais informações, consulte Deprecated Types in Windows Workflow Foundation 4.5 (Tipos preteridos no Windows Workflow Foundation 4.5).

Um Activity é o bloco de construção fundamental dos fluxos de trabalho. Um Activity define um conjunto de propriedades e eventos, como qualquer classe, juntamente com a lógica de execução que define o comportamento de tempo de execução da atividade. Um conjunto de componentes adicionais pode ser associado a um Activity. Elas incluem, mas não se limitam a um validador, um gerador de código, serializadores personalizados e um designer.

Todas as atividades compartilham um conjunto comum de propriedades definidas na Activity classe base. Cada Activity um pode declarar suas próprias propriedades adicionais de acordo com seus requisitos estendendo essa classe. Como Activity deriva de DependencyObject, as propriedades podem ser definidas como propriedades CLR padrão e como propriedades de dependência.

A lógica de execução de um Activity cumpre um contrato que existe entre qualquer Activity e o runtime do fluxo de trabalho. Você deve documentar a lógica de execução de qualquer Activity em um sentido funcional, para que um desenvolvedor de fluxo de trabalho que usa o Activity saiba como ele se comporta. A lógica de execução em si está oculta do desenvolvedor de fluxo de trabalho que inclui a atividade em um fluxo de trabalho, pois a lógica de execução faz parte de um contrato que existe estritamente entre o runtime de fluxo de trabalho e o Activity.

Construtores

Activity()	Obsoleto. Inicializa uma nova instância da classe Activity.
Activity(String)	Obsoleto. Inicializa uma nova instância da classe Activity, ao inicializar o Name.

Campos

ActivityContextGuidProperty	Obsoleto. O DependencyProperty que representa o Guid do ActivityExecutionContext que está associado ao Activity.
CancelingEvent	Obsoleto. Representa o DependencyProperty que destina-se ao evento Canceling.
ClosedEvent	Obsoleto. Representa o DependencyProperty que destina-se ao evento Closed.
CompensatingEvent	Obsoleto. Representa o DependencyProperty que destina-se ao evento Compensating.
ExecutingEvent	Obsoleto. Representa o DependencyProperty que tem como destino o evento Executing que ocorre quando a atividade é executada.
FaultingEvent	Obsoleto. O DependencyProperty que representa o evento Faulting.
StatusChangedEvent	Obsoleto. Representa o DependencyProperty que destina-se ao evento StatusChanged.

Propriedades

Description	Obsoleto. Obtém ou define a descrição definida pelo usuário da Activity.
DesignMode	Obsoleto. Obtém o valor que indica se esta instância está em modo de design ou de tempo de execução. (Herdado de DependencyObject)
Enabled	Obsoleto. Obtém ou define um valor que indica se esta instância está habilitada para execução e validação.
ExecutionResult	Obsoleto. Obtém o ActivityExecutionResult da última tentativa de executar essa instância.
ExecutionStatus	Obsoleto. Obtém o ActivityExecutionStatus atual dessa instância.
IsDynamicActivity	Obsoleto. Obtém informações sobre se a atividade está em execução dentro do ActivityExecutionContext padrão da instância de fluxo de trabalho.
Name	Obsoleto. Obtém ou define o nome desta instância. Este nome deve estar em conformidade com as convenções de nomenclatura de variável da linguagem de programação que está sendo usada no projeto de fluxo de trabalho.
Parent	Obsoleto. Obtém o CompositeActivity que contém esse Activity.
ParentDependencyObject	Obsoleto. Obtém o DependencyObject pai no grafo DependencyObject. (Herdado de DependencyObject)
QualifiedName	Obsoleto. Obtém o nome qualificado da atividade. Nomes de atividades qualificados sempre são exclusivos em uma instância de fluxo de trabalho.
Site	Obsoleto. Obtém ou define uma referência ao componente Site do DependencyObject. (Herdado de DependencyObject)
UserData	Obsoleto. Obtém um IDictionary que associa dados personalizados a essa instância de classe. (Herdado de DependencyObject)
WorkflowInstanceId	Obsoleto. Obtém o Guid associado à instância.

Métodos

AddHandler(DependencyProperty, Object)	Obsoleto. Adiciona um manipulador para um evento de um DependencyObject. (Herdado de DependencyObject)
Cancel(ActivityExecutionContext)	Obsoleto. Chamado pelo runtime de fluxo de trabalho para cancelar a execução de uma atividade que está sendo executada no momento.
Clone()	Obsoleto. Cria uma cópia profunda do Activity.
Dispose()	Obsoleto. Libera todos os recursos usados pelo DependencyObject. (Herdado de DependencyObject)
Dispose(Boolean)	Obsoleto. Libera os recursos não gerenciados usados e opcionalmente os gerenciados usados pelo DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Execute(ActivityExecutionContext)	Obsoleto. Chamado pelo runtime de fluxo de trabalho para executar uma atividade.
GetActivityByName(String)	Obsoleto. Retorna a instância do Activity cujo nome é solicitado do conjunto de todas as atividades em execução na atividade raiz desta instância, que está dentro do fluxo de trabalho.
GetActivityByName(String, Boolean)	Obsoleto. Retorna a instância do Activity cujo nome é solicitado do conjunto de todas as atividades sob a raiz do Activity desta instância se o segundo parâmetro é false e no Activity atual se o parâmetro é true.
GetBinding(DependencyProperty)	Obsoleto. Fornece acesso para ao ActivityBind associado ao DependencyProperty específico. (Herdado de DependencyObject)
GetBoundValue(ActivityBind, Type)	Obsoleto. Recupera o Object que é a entidade de um ActivityBind. (Herdado de DependencyObject)
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetInvocationList<T>(DependencyProperty)	Obsoleto. Obtém uma matriz que contém os delegados para o DependencyProperty especificado. (Herdado de DependencyObject)
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Obsoleto. Fornece acesso ao valor do DependencyProperty designado. (Herdado de DependencyObject)
GetValueBase(DependencyProperty)	Obsoleto. Fornece acesso ao objeto associado de um DependencyProperty e ignora a substituição de GetValue(DependencyProperty). (Herdado de DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	Obsoleto. Chamado quando uma exceção é gerada dentro do contexto da execução desta instância.
Initialize(IServiceProvider)	Obsoleto. Chamado pelo runtime de fluxo de trabalho para inicializar uma atividade durante a construção de uma nova instância de fluxo de trabalho. Este método é chamado durante a construção de um ActivityExecutionContext dinâmico.
InitializeProperties()	Obsoleto. Executa a inicialização nas propriedades de dependência quando substituído em uma classe derivada. (Herdado de DependencyObject)
Invoke<T>(EventHandler<T>, T)	Obsoleto. Assina um EventHandler e invoca esse delegado.
Invoke<T>(IActivityEventListener<T>, T)	Obsoleto. Assina um IActivityEventListener<T> e invoca esse delegado.
IsBindingSet(DependencyProperty)	Obsoleto. Indica se o valor de um DependencyProperty é definido como uma associação. Consulte SetBinding(DependencyProperty, ActivityBind). (Herdado de DependencyObject)
Load(Stream, Activity)	Obsoleto. Carrega uma instância de um Activity de um Stream.
Load(Stream, Activity, IFormatter)	Obsoleto. Carrega uma instância de um Activity em um Stream usando o IFormatter personalizado para a desserialização.
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
MetaEquals(DependencyObject)	Obsoleto. Determina se o metaproperties deste DependencyObject é igual a metaproperties do DependencyObject com parâmetros. (Herdado de DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	Obsoleto. Chamado pelo runtime de fluxo de trabalho sempre que um ActivityExecutionContext é carregado. Por exemplo, este método é chamado durante a criação de um ActivityExecutionContext, bem como toda vez que o ActivityExecutionContext é reencarnado quando uma instância de fluxo de trabalho é carregada do armazenamento persistente.
OnActivityExecutionContextUnload(IServiceProvider)	Obsoleto. Chamado pelo runtime de fluxo de trabalho sempre que um ActivityExecutionContext é descarregado. Por exemplo, este método é chamado durante a conclusão de um ActivityExecutionContext, bem como toda vez que ActivityExecutionContext é descarregado quando uma instância de fluxo de trabalho é persistida.
OnClosed(IServiceProvider)	Obsoleto. Chamado pelo runtime de fluxo de trabalho como parte da transição da atividade para o estado fechado.
RaiseEvent(DependencyProperty, Object, EventArgs)	Obsoleto. Gera um Event associado à propriedade de dependência especificada.
RaiseGenericEvent<T>(DependencyProperty, Object, T)	Obsoleto. Gera o evento associado com o DependencyProperty referenciado.
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleto. Registra o DependencyProperty especificado para o evento de alteração de status.
RemoveHandler(DependencyProperty, Object)	Obsoleto. Remove um EventHandler de um DependencyProperty associado. (Herdado de DependencyObject)
RemoveProperty(DependencyProperty)	Obsoleto. Remove um DependencyProperty do DependencyObject. (Herdado de DependencyObject)
Save(Stream)	Obsoleto. Grava o Activity para um Stream para persistência.
Save(Stream, IFormatter)	Obsoleto. Grava o Activity para um Stream para persistência usando o IFormatter personalizado fornecido para a serialização.
SetBinding(DependencyProperty, ActivityBind)	Obsoleto. Define o ActivityBind para o DependencyProperty especificado. (Herdado de DependencyObject)
SetBoundValue(ActivityBind, Object)	Obsoleto. Define o valor do ActivityBind de destino. (Herdado de DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	Obsoleto. Define o valor de um DependencyProperty, que é somente leitura. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Obsoleto. Define o valor do DependencyProperty para o objeto. (Herdado de DependencyObject)
SetValueBase(DependencyProperty, Object)	Obsoleto. Define o valor da DependencyProperty usando o Object especificado, ignorando o SetValue(DependencyProperty, Object). (Herdado de DependencyObject)
ToString()	Obsoleto. Fornece uma cadeia de caracteres que representa essa instância.
TrackData(Object)	Obsoleto. Informa a infraestrutura de acompanhamento de tempo de execução das informações de acompanhamento pendentes.
TrackData(String, Object)	Obsoleto. Informa a infraestrutura de acompanhamento de tempo de execução das informações de acompanhamento pendentes.
Uninitialize(IServiceProvider)	Obsoleto. Quando substituído em uma classe derivada, fornece o cancelamento de inicialização por um provedor de serviço para a atividade.
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleto. Cancela o registro do DependencyProperty especificado para o evento de alteração de status.

Eventos

Canceling	Obsoleto. Ocorre quando a execução da atividade é cancelada.
Closed	Obsoleto. Ocorre quando um Activity concluiu a execução.
Compensating	Obsoleto. Ocorre durante a execução de um método de compensação no Activity.
Executing	Obsoleto. Ocorre quando o Activity é executado.
Faulting	Obsoleto. Ocorre quando uma exceção é gerada durante a execução da instância.
StatusChanged	Obsoleto. Ocorre quando o ActivityExecutionStatus de um Activity em execução muda.

Implantações explícitas de interface

IComponent.Disposed

Obsoleto. Representa o método que manipula o evento Disposed de um componente. (Herdado de DependencyObject)