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)
Cancel(ActivityExecutionContext)	已淘汰. 由工作流程執行階段呼叫，以取消執行目前執行的活動。
Clone()	已淘汰. 建立 Activity 的深層複本 (Deep Copy)。
Dispose()	已淘汰. 釋放 DependencyObject 使用的所有資源。 (繼承來源 DependencyObject)
Dispose(Boolean)	已淘汰. 會釋放 Unmanaged 資源，並選擇性地釋放 DependencyObject 所使用的 Managed 資源。 (繼承來源 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)	已淘汰. 判斷這個 的 是否相等於參數化 的 。 (繼承來源 DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	已淘汰. 每當載入 ActivityExecutionContext 時，由工作流程執行階段呼叫。 例如，在建立 ActivityExecutionContext 期間，以及每次當從持續性儲存體載入工作流程執行個體時具體化 ActivityExecutionContext 時，呼叫這個方法。
OnActivityExecutionContextUnload(IServiceProvider)	已淘汰. 每當卸載 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 寫入保存性 (Persistence) 的 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	已淘汰. 發生於正在執行之 的 變更時。

明確介面實作

IComponent.Disposed

已淘汰. 表示處理元件 Disposed 事件的方法。 (繼承來源 DependencyObject)