Activity Класс

Определение

Пространство имен:

System.Workflow.ComponentModel

Сборка:

System.Workflow.ComponentModel.dll

Внимание!

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

Представляет основной строительный блок рабочих процессов. Activity — это базовый класс для всех действий.

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

Наследование

Object

DependencyObject

Activity

Производный

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

Атрибуты

ToolboxBitmapAttribute ActivityCodeGeneratorAttribute ActivityValidatorAttribute RuntimeNamePropertyAttribute ObsoleteAttribute

Примеры

В этом примере определяется действие, задачей которого является отправка сообщений по электронной почте. Действие определяет одно свойство, Subject, для реализации которого используется свойство зависимостей. Другие свойства могут быть определены сходным образом. Метод Execute переопределяется для создания логики для отправки сообщений по электронной почте. Полный пример см. в разделе Пример действия отправки 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;  
    }  
}  

Комментарии

Примечание

В этом материале обсуждаются устаревшие типы и пространства имен. Дополнительные сведения см. в статье о нерекомендуемых типах в Windows Workflow Foundation 4.5.

Activity — основной строительный блок рабочих процессов. Объект Activity определяет набор свойств и событий, таких как любой класс, одновременно с логикой выполнения, которая определяет поведение действия во время выполнения. С объектом Activity может быть связан набор дополнительных компонентов. Возможные, но не единственные компоненты: проверяющий элемент управления, генератор кода, пользовательские сериализаторы, конструктор.

Все действия совместно используют набор свойств, определенных для базового класса Activity. Каждый объект Activity может при необходимости декларировать собственные дополнительные свойства, расширяя данный класс. Поскольку класс Activity наследуется от класса DependencyObject, свойства можно определять как стандартные свойства среды CLR и свойства зависимостей.

Логика выполнения объектов Activity соблюдает условия контракта, который существует между любым объектом Activity и средой выполнения рабочих процессов. Необходимо описывать функциональную логику выполнения любого действия Activity, чтобы разработчик рабочих процессов, использующий действие Activity понимал, как оно будет работать. Сама по себе логика выполнения скрыта от разработчика, включающего действие в рабочий процесс, так как логика выполнения является частью контракта, существующего только между средой выполнения рабочих процессов и объектами Activity.

Конструкторы

Activity()	Устаревшие.. Инициализирует новый экземпляр класса Activity.
Activity(String)	Устаревшие.. Инициализирует новый экземпляр класса Activity, инициализируя объект Name.

Поля

ActivityContextGuidProperty	Устаревшие.. Объект DependencyProperty, который представляет Guid объекта ActivityExecutionContext, связанного с действием Activity.
CancelingEvent	Устаревшие.. Представляет объект DependencyProperty, который нацелен на событие Canceling.
ClosedEvent	Устаревшие.. Представляет объект DependencyProperty, который нацелен на событие Closed.
CompensatingEvent	Устаревшие.. Представляет объект DependencyProperty, который нацелен на событие Compensating.
ExecutingEvent	Устаревшие.. Представляет объект DependencyProperty, который нацелен на событие Executing, которое происходит при выполнении действия.
FaultingEvent	Устаревшие.. Объект DependencyProperty, который представляет событие Faulting.
StatusChangedEvent	Устаревшие.. Представляет объект DependencyProperty, который нацелен на событие StatusChanged.

Свойства

Description	Устаревшие.. Возвращает или задает пользовательское описание объекта Activity.
DesignMode	Устаревшие.. Возвращает значение, показывающее, в каком режиме находится данный экземпляр — режиме конструктора или режиме выполнения. (Унаследовано от DependencyObject)
Enabled	Устаревшие.. Возвращает или задает значение, указывающее, разрешены ли для этого экземпляра выполнение и проверка.
ExecutionResult	Устаревшие.. Возвращает результат ActivityExecutionResult последней попытки запуска экземпляра.
ExecutionStatus	Устаревшие.. Возвращает текущее состояние ActivityExecutionStatus экземпляра.
IsDynamicActivity	Устаревшие.. Возвращает сведения о том, выполняется ли действие в рамках ActivityExecutionContext по умолчанию для экземпляра рабочего процесса.
Name	Устаревшие.. Возвращает или задает имя экземпляра. Имя должно соответствовать стандартным правилам именования переменных языка программирования, использованного в проекте.
Parent	Устаревшие.. Возвращает составное действие CompositeActivity, в котором содержится данный объект Activity.
ParentDependencyObject	Устаревшие.. Возвращает родительский объект DependencyObject в графе DependencyObject. (Унаследовано от DependencyObject)
QualifiedName	Устаревшие.. Возвращает полное имя действия. Полные имена действий всегда уникальны в рамках экземпляра рабочего процесса.
Site	Устаревшие.. Возвращает или задает ссылку на компонент Site объекта DependencyObject. (Унаследовано от DependencyObject)
UserData	Устаревшие.. Возвращает коллекцию IDictionary, которая связывает пользовательские данные с этим экземпляром класса. (Унаследовано от DependencyObject)
WorkflowInstanceId	Устаревшие.. Возвращает идентификатор Guid, связанный с экземпляром.

Методы

AddHandler(DependencyProperty, Object)	Устаревшие.. Добавляет обработчик для события DependencyObject. (Унаследовано от DependencyObject)
Cancel(ActivityExecutionContext)	Устаревшие.. Вызывается средой выполнения рабочих процессов для отмены выполнения действия, которое выполняется в настоящий момент.
Clone()	Устаревшие.. Создает глубокую копию объекта Activity.
Dispose()	Устаревшие.. Освобождает все ресурсы, используемые объектом DependencyObject. (Унаследовано от DependencyObject)
Dispose(Boolean)	Устаревшие.. Освобождает неуправляемые ресурсы и факультативно освобождает управляемые ресурсы, используемые объектом DependencyObject. (Унаследовано от DependencyObject)
Equals(Object)	Устаревшие.. Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Execute(ActivityExecutionContext)	Устаревшие.. Вызывается средой выполнения рабочих процессов для выполнения действия.
GetActivityByName(String)	Устаревшие.. Возвращает экземпляр Activity, имя которого запрошено, из набора всех действий, выполняемых в рамках корневого действия экземпляра, то есть в рамках рабочего процесса.
GetActivityByName(String, Boolean)	Устаревшие.. Возвращает экземпляр Activity, имя которого запрошено, из набора всех действий, выполняемых в рамках корневого действия Activity экземпляра, если второй параметр имеет значение false, или в рамках текущего действия Activity, если второй параметр имеет значение true.
GetBinding(DependencyProperty)	Устаревшие.. Предоставляет доступ к объекту ActivityBind, связанному с конкретным объектом DependencyProperty. (Унаследовано от DependencyObject)
GetBoundValue(ActivityBind, Type)	Устаревшие.. Извлекает объект Object, который является субъектом ActivityBind. (Унаследовано от DependencyObject)
GetHashCode()	Устаревшие.. Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInvocationList<T>(DependencyProperty)	Устаревшие.. Возвращает массив, содержащий делегаты для заданного свойства DependencyProperty. (Унаследовано от DependencyObject)
GetType()	Устаревшие.. Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Устаревшие.. Предоставляет доступ к значению заданного свойства DependencyProperty. (Унаследовано от DependencyObject)
GetValueBase(DependencyProperty)	Устаревшие.. Предоставляет доступ к связанному объекту DependencyProperty и обходит переопределение метода GetValue(DependencyProperty). (Унаследовано от DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	Устаревшие.. Вызывается при возникновении исключения в контексте выполнения данного экземпляра.
Initialize(IServiceProvider)	Устаревшие.. Вызывается средой выполнения рабочих процессов для инициализации действия во время создания нового экземпляра рабочего процесса. Метод вызывается во время создания динамического объекта ActivityExecutionContext.
InitializeProperties()	Устаревшие.. При переопределении в производном классе выполняет инициализацию свойств зависимостей. (Унаследовано от DependencyObject)
Invoke<T>(EventHandler<T>, T)	Устаревшие.. Подписывает объект EventHandler и вызывает делегат.
Invoke<T>(IActivityEventListener<T>, T)	Устаревшие.. Подписывает объект IActivityEventListener<T> и вызывает делегат.
IsBindingSet(DependencyProperty)	Устаревшие.. Указывает, задано ли значение DependencyProperty как привязка. См. раздел SetBinding(DependencyProperty, ActivityBind). (Унаследовано от DependencyObject)
Load(Stream, Activity)	Устаревшие.. Загружает экземпляр действия Activity из объекта Stream.
Load(Stream, Activity, IFormatter)	Устаревшие.. Загружает экземпляр Activity из объекта Stream, применяя пользовательский интерфейс IFormatter для десериализации.
MemberwiseClone()	Устаревшие.. Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MetaEquals(DependencyObject)	Устаревшие.. Определяет, совпадают ли свойства metaproperties этого объекта DependencyObject со свойствами metaproperties параметризованного объекта DependencyObject. (Унаследовано от DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	Устаревшие.. Вызывается средой выполнения рабочих процессов при каждой загрузке объекта ActivityExecutionContext. Например, этот метод вызывается во время создания объекта ActivityExecutionContext, а также при каждом повторном воплощении объекта ActivityExecutionContext во время загрузки экземпляра рабочего процесса из постоянного хранилища.
OnActivityExecutionContextUnload(IServiceProvider)	Устаревшие.. Вызывается средой выполнения рабочих процессов каждый раз, как выгружается объект ActivityExecutionContext. Например, этот метод вызывается во время завершения ActivityExecutionContext, а также каждый раз при выгрузке объекта ActivityExecutionContext, если экземпляр рабочего процесса сохраняется.
OnClosed(IServiceProvider)	Устаревшие.. Вызывается средой выполнения рабочих процессов и является частью перехода действия в закрытое состояние.
RaiseEvent(DependencyProperty, Object, EventArgs)	Устаревшие.. Вызывает событие Event, связанное с заданным свойством зависимостей.
RaiseGenericEvent<T>(DependencyProperty, Object, T)	Устаревшие.. Порождает событие, связанное с объектом DependencyProperty, на который существует ссылка.
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Устаревшие.. Регистрирует заданный объект DependencyProperty для события изменения состояния.
RemoveHandler(DependencyProperty, Object)	Устаревшие.. Удаляет EventHandler из связанного объекта DependencyProperty. (Унаследовано от DependencyObject)
RemoveProperty(DependencyProperty)	Устаревшие.. Удаляет объект DependencyProperty из объекта DependencyObject. (Унаследовано от DependencyObject)
Save(Stream)	Устаревшие.. Записывает действие Activity в объект Stream для сохранения.
Save(Stream, IFormatter)	Устаревшие.. Записывает действие Activity в объект Stream для сохранения, применяя пользовательский интерфейс IFormatter для сериализации.
SetBinding(DependencyProperty, ActivityBind)	Устаревшие.. Задает объект ActivityBind для указанного объекта DependencyProperty. (Унаследовано от DependencyObject)
SetBoundValue(ActivityBind, Object)	Устаревшие.. Задает значение целевого объекта ActivityBind. (Унаследовано от DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	Устаревшие.. Задает значение свойства DependencyProperty только для чтения. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Устаревшие.. Присваивает значение DependencyProperty объекту. (Унаследовано от DependencyObject)
SetValueBase(DependencyProperty, Object)	Устаревшие.. Задает значение свойства DependencyProperty равным указанному объекту Object в обход метода SetValue(DependencyProperty, Object). (Унаследовано от DependencyObject)
ToString()	Устаревшие.. Возвращает строку, представляющую данный экземпляр.
TrackData(Object)	Устаревшие.. Передает в инфраструктуру отслеживания среды выполнения отложенные сведения об отслеживании.
TrackData(String, Object)	Устаревшие.. Передает в инфраструктуру отслеживания среды выполнения отложенные сведения об отслеживании.
Uninitialize(IServiceProvider)	Устаревшие.. При переопределении в производном классе обеспечивает деинициализацию поставщиком служб для действия.
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Устаревшие.. Отменяет регистрацию заданного объекта DependencyProperty для события изменения состояния.

События

Canceling	Устаревшие.. Происходит при отмене выполнения действия.
Closed	Устаревшие.. Происходит при завершении выполнения действия Activity.
Compensating	Устаревшие.. Происходит при выполнении метода компенсации для действия Activity.
Executing	Устаревшие.. Происходит при выполнении действия Activity.
Faulting	Устаревшие.. Происходит при возникновении исключения во время выполнения экземпляра.
StatusChanged	Устаревшие.. Происходит при изменении состояния ActivityExecutionStatus действия Activity.

Явные реализации интерфейса

IComponent.Disposed

Устаревшие.. Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от DependencyObject)