Activity Класс

Определение

Внимание!

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

Представляет основной строительный блок рабочих процессов.Represents the fundamental building block of workflows. Activity — это базовый класс для всех действий.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.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")>]
type Activity = class
    inherit 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
Наследование
Производный
Атрибуты

Примеры

В этом примере определяется действие, задачей которого является отправка сообщений по электронной почте.This example defines an activity whose purpose is to send an email. Действие определяет одно свойство, Subject, для реализации которого используется свойство зависимостей.The activity defines one property, Subject, that uses a dependency property in its implementation. Другие свойства могут быть определены сходным образом.Other properties can be defined in a similar way. Метод Execute переопределяется для создания логики для отправки сообщений по электронной почте.The Execute method is overridden to provide the logic for sending the email. Полный пример см. в примере действия Send e-mail.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;  
    }  
}  

Комментарии

Примечание

В этом материале обсуждаются устаревшие типы и пространства имен.This material discusses types and namespaces that are obsolete. Дополнительные сведения см. в статье о нерекомендуемых типах в Windows Workflow Foundation 4.5.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Activity — основной строительный блок рабочих процессов.An Activity is the fundamental building block of workflows. Объект Activity определяет набор свойств и событий, таких как любой класс, одновременно с логикой выполнения, которая определяет поведение действия во время выполнения.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. С объектом Activity может быть связан набор дополнительных компонентов.A set of additional components can be associated with an Activity. Возможные, но не единственные компоненты: проверяющий элемент управления, генератор кода, пользовательские сериализаторы, конструктор.These include, but are not limited to a validator, a code generator, custom serializers, and a designer.

Все действия совместно используют набор свойств, определенных для базового класса Activity.All activities share a common set of properties defined on the Activity base class. Каждый объект Activity может при необходимости декларировать собственные дополнительные свойства, расширяя данный класс.Each Activity can declare its own additional properties according to its requirements by extending this class. Поскольку класс Activity наследуется от класса DependencyObject, свойства можно определять как стандартные свойства среды CLR и свойства зависимостей.Because Activity derives from DependencyObject, properties can be defined as standard CLR properties and as dependency properties.

Логика выполнения объектов Activity соблюдает условия контракта, который существует между любым объектом Activity и средой выполнения рабочих процессов.The execution logic of an Activity fulfills a contract that exists between any Activity and the workflow runtime. Необходимо описывать функциональную логику выполнения любого действия Activity, чтобы разработчик рабочих процессов, использующий действие Activity понимал, как оно будет работать.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. Сама по себе логика выполнения скрыта от разработчика, включающего действие в рабочий процесс, так как логика выполнения является частью контракта, существующего только между средой выполнения рабочих процессов и объектами 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.

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

Activity()

Инициализирует новый экземпляр класса Activity.Initializes a new instance of the Activity class.

Activity(String)

Инициализирует новый экземпляр класса Activity, инициализируя объект Name.Initializes a new instance of the Activity class, while initializing the Name.

Поля

ActivityContextGuidProperty

Объект DependencyProperty, который представляет Guid объекта ActivityExecutionContext, связанного с действием Activity.The DependencyProperty that represents the Guid of the ActivityExecutionContext that is associated with the Activity.

CancelingEvent

Представляет объект DependencyProperty, который нацелен на событие Canceling.Represents the DependencyProperty that targets the Canceling event.

ClosedEvent

Представляет объект DependencyProperty, который нацелен на событие Closed.Represents the DependencyProperty that targets the Closed event.

CompensatingEvent

Представляет объект DependencyProperty, который нацелен на событие Compensating.Represents the DependencyProperty that targets the Compensating event.

ExecutingEvent

Представляет объект DependencyProperty, который нацелен на событие Executing, которое происходит при выполнении действия.Represents the DependencyProperty that targets the Executing event, which occurs when the activity is executed.

FaultingEvent

Объект DependencyProperty, который представляет событие Faulting.The DependencyProperty that represents the Faulting event.

StatusChangedEvent

Представляет объект DependencyProperty, который нацелен на событие StatusChanged.Represents the DependencyProperty that targets the StatusChanged event.

Свойства

Description

Возвращает или задает пользовательское описание объекта Activity.Gets or sets the user-defined description of the Activity.

DesignMode

Возвращает значение, показывающее, в каком режиме находится данный экземпляр — режиме конструктора или режиме выполнения.Gets the value that indicates whether this instance is in design or run-time mode.

(Унаследовано от DependencyObject)
Enabled

Возвращает или задает значение, указывающее, разрешены ли для этого экземпляра выполнение и проверка.Gets or sets a value that indicates whether this instance is enabled for execution and validation.

ExecutionResult

Возвращает результат ActivityExecutionResult последней попытки запуска экземпляра.Gets the ActivityExecutionResult of the last attempt to run this instance.

ExecutionStatus

Возвращает текущее состояние ActivityExecutionStatus экземпляра.Gets the current ActivityExecutionStatus of this instance.

IsDynamicActivity

Возвращает сведения о том, выполняется ли действие в рамках ActivityExecutionContext по умолчанию для экземпляра рабочего процесса.Gets information about whether the activity is executing within the default ActivityExecutionContext of the workflow instance.

Name

Возвращает или задает имя экземпляра.Gets or sets the name of this instance. Имя должно соответствовать стандартным правилам именования переменных языка программирования, использованного в проекте.This name must conform to the variable naming convention of the programming language that is being used in the Workflow project.

Parent

Возвращает составное действие CompositeActivity, в котором содержится данный объект Activity.Gets the CompositeActivity that contains this Activity.

ParentDependencyObject

Возвращает родительский объект DependencyObject в графе DependencyObject.Gets the parent DependencyObject in the DependencyObject graph.

(Унаследовано от DependencyObject)
QualifiedName

Возвращает полное имя действия.Gets the qualified name of the activity. Полные имена действий всегда уникальны в рамках экземпляра рабочего процесса.Qualified activity names are always unique in a workflow instance.

Site

Возвращает или задает ссылку на компонент Site объекта DependencyObject.Gets or sets a reference to the Site component of the DependencyObject.

(Унаследовано от DependencyObject)
UserData

Возвращает коллекцию IDictionary, которая связывает пользовательские данные с этим экземпляром класса.Gets an IDictionary that associates custom data with this class instance.

(Унаследовано от DependencyObject)
WorkflowInstanceId

Возвращает идентификатор Guid, связанный с экземпляром.Gets the Guid associated with the instance.

Методы

AddHandler(DependencyProperty, Object)

Добавляет обработчик для события DependencyObject.Adds a handler for an event of a DependencyObject.

(Унаследовано от DependencyObject)
Cancel(ActivityExecutionContext)

Вызывается средой выполнения рабочих процессов для отмены выполнения действия, которое выполняется в настоящий момент.Called by the workflow runtime to cancel execution of an activity that is currently executing.

Clone()

Создает глубокую копию объекта Activity.Creates a deep copy of the Activity.

Dispose()

Освобождает все ресурсы, используемые объектом DependencyObject.Releases all the resources used by the DependencyObject.

(Унаследовано от DependencyObject)
Dispose(Boolean)

Освобождает неуправляемые ресурсы и факультативно освобождает управляемые ресурсы, используемые объектом DependencyObject.Releases the unmanaged resources and optionally releases the managed resources used by DependencyObject.

(Унаследовано от DependencyObject)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Execute(ActivityExecutionContext)

Вызывается средой выполнения рабочих процессов для выполнения действия.Called by the workflow runtime to execute an activity.

GetActivityByName(String)

Возвращает экземпляр Activity, имя которого запрошено, из набора всех действий, выполняемых в рамках корневого действия экземпляра, то есть в рамках рабочего процесса.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)

Возвращает экземпляр Activity, имя которого запрошено, из набора всех действий, выполняемых в рамках корневого действия Activity экземпляра, если второй параметр имеет значение false, или в рамках текущего действия Activity, если второй параметр имеет значение 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)

Предоставляет доступ к объекту ActivityBind, связанному с конкретным объектом DependencyProperty.Provides access to the ActivityBind associated with the specific DependencyProperty.

(Унаследовано от DependencyObject)
GetBoundValue(ActivityBind, Type)

Извлекает объект Object, который является субъектом ActivityBind.Retrieves the Object that is the subject of an ActivityBind.

(Унаследовано от DependencyObject)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetInvocationList<T>(DependencyProperty)

Возвращает массив, содержащий делегаты для заданного свойства DependencyProperty.Gets an array that contains the delegates for the specified DependencyProperty.

(Унаследовано от DependencyObject)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(DependencyProperty)

Предоставляет доступ к значению заданного свойства DependencyProperty.Provides access to the value of the designated DependencyProperty.

(Унаследовано от DependencyObject)
GetValueBase(DependencyProperty)

Предоставляет доступ к связанному объекту DependencyProperty и обходит переопределение метода GetValue(DependencyProperty).Provides access to the bound object of a DependencyProperty and bypasses the GetValue(DependencyProperty) override.

(Унаследовано от DependencyObject)
HandleFault(ActivityExecutionContext, Exception)

Вызывается при возникновении исключения в контексте выполнения данного экземпляра.Called when an exception is raised within the context of the execution of this instance.

Initialize(IServiceProvider)

Вызывается средой выполнения рабочих процессов для инициализации действия во время создания нового экземпляра рабочего процесса.Called by the workflow runtime to initialize an activity during the construction of a new workflow instance. Метод вызывается во время создания динамического объекта ActivityExecutionContext.This method is called during the construction of a dynamic ActivityExecutionContext.

InitializeProperties()

При переопределении в производном классе выполняет инициализацию свойств зависимостей.Performs initialization on dependency properties when overridden in a derived class.

(Унаследовано от DependencyObject)
Invoke<T>(EventHandler<T>, T)

Подписывает объект EventHandler и вызывает делегат.Subscribes an EventHandler and invokes that delegate.

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

Подписывает объект IActivityEventListener<T> и вызывает делегат.Subscribes an IActivityEventListener<T> and invokes that delegate.

IsBindingSet(DependencyProperty)

Указывает, задано ли значение DependencyProperty как привязка.Indicates whether the value of a DependencyProperty is set as a binding. См. раздел SetBinding(DependencyProperty, ActivityBind).See SetBinding(DependencyProperty, ActivityBind).

(Унаследовано от DependencyObject)
Load(Stream, Activity)

Загружает экземпляр действия Activity из объекта Stream.Loads an instance of an Activity from a Stream.

Load(Stream, Activity, IFormatter)

Загружает экземпляр Activity из объекта Stream, применяя пользовательский интерфейс IFormatter для десериализации.Loads an instance of an Activity from a Stream using the custom IFormatter for deserialization.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MetaEquals(DependencyObject)

Определяет, совпадают ли свойства metaproperties этого объекта DependencyObject со свойствами metaproperties параметризованного объекта DependencyObject.Determines whether the metaproperties of this DependencyObject equals the metaproperties of the parameterized DependencyObject.

(Унаследовано от DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

Вызывается средой выполнения рабочих процессов при каждой загрузке объекта ActivityExecutionContext.Called by the workflow runtime whenever an ActivityExecutionContext is loaded. Например, этот метод вызывается во время создания объекта ActivityExecutionContext, а также при каждом повторном воплощении объекта ActivityExecutionContext во время загрузки экземпляра рабочего процесса из постоянного хранилища.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)

Вызывается средой выполнения рабочих процессов каждый раз, как выгружается объект ActivityExecutionContext.Called by the workflow runtime whenever an ActivityExecutionContext is unloaded. Например, этот метод вызывается во время завершения ActivityExecutionContext, а также каждый раз при выгрузке объекта ActivityExecutionContext, если экземпляр рабочего процесса сохраняется.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)

Вызывается средой выполнения рабочих процессов и является частью перехода действия в закрытое состояние.Called by the workflow runtime as part of the activity's transition to the closed state.

RaiseEvent(DependencyProperty, Object, EventArgs)

Вызывает событие Event, связанное с заданным свойством зависимостей.Raises an Event associated with the specified dependency property.

RaiseGenericEvent<T>(DependencyProperty, Object, T)

Порождает событие, связанное с объектом DependencyProperty, на который существует ссылка.Raises the event associated with the referenced DependencyProperty.

RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Регистрирует заданный объект DependencyProperty для события изменения состояния.Registers the specified DependencyProperty for the status change event.

RemoveHandler(DependencyProperty, Object)

Удаляет EventHandler из связанного объекта DependencyProperty.Removes an EventHandler from an associated DependencyProperty.

(Унаследовано от DependencyObject)
RemoveProperty(DependencyProperty)

Удаляет объект DependencyProperty из объекта DependencyObject.Removes a DependencyProperty from the DependencyObject.

(Унаследовано от DependencyObject)
Save(Stream)

Записывает действие Activity в объект Stream для сохранения.Writes the Activity to a Stream for persistence.

Save(Stream, IFormatter)

Записывает действие Activity в объект Stream для сохранения, применяя пользовательский интерфейс IFormatter для сериализации.Writes the Activity to a Stream for persistence using the custom IFormatter provided for serialization.

SetBinding(DependencyProperty, ActivityBind)

Задает объект ActivityBind для указанного объекта DependencyProperty.Sets the ActivityBind for the specified DependencyProperty.

(Унаследовано от DependencyObject)
SetBoundValue(ActivityBind, Object)

Задает значение целевого объекта ActivityBind.Sets the value of the target ActivityBind.

(Унаследовано от DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)

Задает значение свойства DependencyProperty только для чтения.Sets the value of a DependencyProperty, which is read-only.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Присваивает значение DependencyProperty объекту.Sets the value of the DependencyProperty to the object.

(Унаследовано от DependencyObject)
SetValueBase(DependencyProperty, Object)

Задает значение свойства DependencyProperty равным указанному объекту Object в обход метода SetValue(DependencyProperty, Object).Sets the value of the DependencyProperty to the specified Object, bypassing the SetValue(DependencyProperty, Object).

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую данный экземпляр.Provides a string that represents this instance.

TrackData(Object)

Передает в инфраструктуру отслеживания среды выполнения отложенные сведения об отслеживании.Informs the run-time tracking infrastructure of pending tracking information.

TrackData(String, Object)

Передает в инфраструктуру отслеживания среды выполнения отложенные сведения об отслеживании.Informs the run-time tracking infrastructure of pending tracking information.

Uninitialize(IServiceProvider)

При переопределении в производном классе обеспечивает деинициализацию поставщиком служб для действия.When overridden in a derived class, provides un-initialization by a service provider for the activity.

UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Отменяет регистрацию заданного объекта DependencyProperty для события изменения состояния.Un-registers the specified DependencyProperty for the status change event.

События

Canceling

Происходит при отмене выполнения действия.Occurs when the activity execution is canceled.

Closed

Происходит при завершении выполнения действия Activity.Occurs when an Activity has completed execution.

Compensating

Происходит при выполнении метода компенсации для действия Activity.Occurs when running a compensation method on the Activity.

Executing

Происходит при выполнении действия Activity.Occurs when the Activity is run.

Faulting

Происходит при возникновении исключения во время выполнения экземпляра.Occurs when an exception is raised during the running of the instance.

StatusChanged

Происходит при изменении состояния ActivityExecutionStatus действия Activity.Occurs when the ActivityExecutionStatus of a running Activity changes.

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

IComponent.Disposed

Представляет метод, обрабатывающий событие Disposed компонента.Represents the method that handles the Disposed event of a component.

(Унаследовано от DependencyObject)

Применяется к