IfElseActivity 類別

定義

警告

此 API 現已淘汰。

條件式執行 IfElseBranchActivity 型別中兩個以上活動的其中一個。Conditionally runs one of two or more activities of type IfElseBranchActivity. 這個類別無法被繼承。This class cannot be inherited.

public ref class IfElseActivity sealed : System::Workflow::ComponentModel::CompositeActivity, System::Workflow::ComponentModel::IActivityEventListener<System::Workflow::ComponentModel::ActivityExecutionStatusChangedEventArgs ^>
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.IfElseActivity), "Resources.Decision.png")]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.IfElseValidator))]
public sealed class IfElseActivity : System.Workflow.ComponentModel.CompositeActivity, System.Workflow.ComponentModel.IActivityEventListener<System.Workflow.ComponentModel.ActivityExecutionStatusChangedEventArgs>
type IfElseActivity = class
    inherit CompositeActivity
    interface IActivityEventListener<ActivityExecutionStatusChangedEventArgs>
Public NotInheritable Class IfElseActivity
Inherits CompositeActivity
Implements IActivityEventListener(Of ActivityExecutionStatusChangedEventArgs)
繼承
屬性
實作

範例

下列程式碼範例顯示如何建立 IfElseActivity 類別的新執行個體,並在其中加入兩個 IfElseBranchActivity 類別。The following code example shows how to create a new instance of the IfElseActivity class and add two IfElseBranchActivity classes to it. 這個程式碼範例是 SequentialWorkflow.cs 檔案中<SequentialWorkflowWithParameters SDK>範例的一部分。This code example is part of the SequentialWorkflowWithParameters SDK Sample from the SequentialWorkflow.cs file. 如需詳細資訊, 請參閱具有參數的工作流程範例For more information, see Workflow with Parameters Sample.

this.CanModifyActivities = true;
System.Workflow.Activities.CodeCondition codecondition1 = new System.Workflow.Activities.CodeCondition();
this.ifElseActivity = new System.Workflow.Activities.IfElseActivity();
this.approveIfElseBranch = new System.Workflow.Activities.IfElseBranchActivity();
this.rejecteIfElseBranch = new System.Workflow.Activities.IfElseBranchActivity();
this.approve = new System.Workflow.Activities.CodeActivity();
this.reject = new System.Workflow.Activities.CodeActivity();
// 
// ifElseActivity
// 
this.ifElseActivity.Activities.Add(this.approveIfElseBranch);
this.ifElseActivity.Activities.Add(this.rejecteIfElseBranch);
this.ifElseActivity.Name = "ifElseActivity";
Me.CanModifyActivities = True
Dim codecondition1 As System.Workflow.Activities.CodeCondition = New System.Workflow.Activities.CodeCondition
Me.ifElseActivity = New System.Workflow.Activities.IfElseActivity
Me.approveIfElseBranch = New System.Workflow.Activities.IfElseBranchActivity
Me.rejecteIfElseBranch = New System.Workflow.Activities.IfElseBranchActivity
Me.approve = New System.Workflow.Activities.CodeActivity
Me.reject = New System.Workflow.Activities.CodeActivity
' 
' ifElseActivity
' 
Me.ifElseActivity.Activities.Add(Me.approveIfElseBranch)
Me.ifElseActivity.Activities.Add(Me.rejecteIfElseBranch)
Me.ifElseActivity.Name = "ifElseActivity"

備註

注意

此資料討論已被汰換的類型及命名空間。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.

這個活動提供的語意與兩個 If-ElseIf 陳述式提供的語意類似。This activity provides semantics similar to two If-ElseIf statements.

IfElseActivity 包含 IfElseBranchActivity 類別的已排序集合,且會在條件評估為 true 時執行第一個分支。IfElseActivity contains an ordered set of IfElseBranchActivity classes and runs the first branch when the condition evaluates to true. 最後的分支不需要條件,在此狀況下,條件永遠會評估為 trueThe final branch is not required to have a condition, in which case it always evaluates to true.

如果未滿足任何條件,則不需執行任何子活動,即可完成 IfElseActivityA IfElseActivity can complete without having run any child activity, if no conditions are satisfied.

建構函式

IfElseActivity()

初始化 IfElseActivity 類別的新執行個體。Initializes a new instance of the IfElseActivity class.

IfElseActivity(String)

使用活動的名稱,初始化 IfElseActivity 類別的新執行個體。Initializes a new instance of the IfElseActivity class using the name of the activity.

屬性

Activities

取得物件,這個物件代表所有子活動的集合 ActivityCollectionGets the object representing the collection, ActivityCollection, of all child activities.

(繼承來源 CompositeActivity)
CanModifyActivities

取得或設定值,這個值可控制是否會修改 Activities 內的個別活動。Gets or sets a value which controls whether the individual activities within Activities can be modified.

(繼承來源 CompositeActivity)
Description

取得或設定 Activity 的使用者定義描述。Gets or sets the user-defined description of the Activity.

(繼承來源 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.

(繼承來源 Activity)
EnabledActivities

取得唯讀集合,這個集合代表已啟用 Activities 的子集。Gets the read-only collection that represents the subset of Activities that are enabled.

(繼承來源 CompositeActivity)
ExecutionResult

取得最後嘗試要執行這個執行個體的 ActivityExecutionResultGets the ActivityExecutionResult of the last attempt to run this instance.

(繼承來源 Activity)
ExecutionStatus

取得這個執行個體的目前 ActivityExecutionStatusGets the current ActivityExecutionStatus of this instance.

(繼承來源 Activity)
IsDynamicActivity

取得有關活動是否執行於工作流程執行個體之預設 ActivityExecutionContext 內的資訊。Gets information about whether the activity is executing within the default ActivityExecutionContext of the workflow instance.

(繼承來源 Activity)
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.

(繼承來源 Activity)
Parent

取得含有這個 CompositeActivityActivityGets the CompositeActivity that contains this Activity.

(繼承來源 Activity)
ParentDependencyObject

取得 DependencyObject 圖形中的父代 DependencyObjectGets 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.

(繼承來源 Activity)
Site

取得或設定 SiteDependencyObject 元件的參考。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

取得與執行個體相關聯的 GuidGets the Guid associated with the instance.

(繼承來源 Activity)

方法

AddBranch(ICollection<Activity>)

使用要加入至新分支的新活動集合,將新分支加入至 IfElseActivityAdds a new branch to the IfElseActivity using a collection of new activities to add to the new branch.

AddBranch(ICollection<Activity>, ActivityCondition)

使用要加入至新分支的新活動集合,將新分支加入至 IfElseActivityAdds a new branch to the IfElseActivity using a collection of new activities to add to the new branch.

AddHandler(DependencyProperty, Object)

加入 DependencyObject之事件的處理常式。Adds a handler for an event of a DependencyObject.

(繼承來源 DependencyObject)
ApplyWorkflowChanges(WorkflowChanges)

將參數中的 WorkflowChanges 資訊清單套用至這個執行個體。Applies the WorkflowChanges manifest in the parameter to this instance.

(繼承來源 CompositeActivity)
Cancel(ActivityExecutionContext)

由工作流程執行階段呼叫,以取消執行目前執行的活動。Called by the workflow runtime to cancel execution of an activity that is currently executing.

(繼承來源 Activity)
Clone()

建立 Activity 的深層複本 (Deep Copy)。Creates a deep copy of the Activity.

(繼承來源 Activity)
Dispose()

釋放 DependencyObject 使用的所有資源。Releases all the resources used by the DependencyObject.

(繼承來源 DependencyObject)
Dispose(Boolean)

呼叫這個執行個體上的 Dispose(Boolean),並選擇性呼叫這個執行個體其所有子活動上的 Dispose()Calls Dispose(Boolean) on this instance, and optionally calls Dispose() on all child activities of this instance.

(繼承來源 CompositeActivity)
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.

(繼承來源 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.

(繼承來源 Activity)
GetActivityByName(String, Boolean)

傳回 Activity 的執行個體,如果第二個參數是 false,則要求其名稱的來源是在這個執行個體其 Activity 的根項目之下的所有活動集,如果第二個參數是 true,則來源是在目前 Activity 之下。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.

(繼承來源 Activity)
GetBinding(DependencyProperty)

提供存取與特定 ActivityBind 相關聯的 DependencyPropertyProvides 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)
GetDynamicActivities(Activity)

傳回陣列,這個陣列包含指定活動之所有目前執行的執行個體。Returns an array that contains all of the currently executing instances of the specified activity.

(繼承來源 CompositeActivity)
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()

取得目前執行個體的 TypeGets 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.

(繼承來源 CompositeActivity)
Initialize(IServiceProvider)

初始化這個執行個體和所指定 IServiceProvider 的所有適當的子活動。Initializes all appropriate child activities of this instance and the specified IServiceProvider.

(繼承來源 CompositeActivity)
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.

(繼承來源 Activity)
Invoke<T>(IActivityEventListener<T>, T)

訂閱 IActivityEventListener<T> 並叫用該委派。Subscribes an IActivityEventListener<T> and invokes that delegate.

(繼承來源 Activity)
IsBindingSet(DependencyProperty)

指出 DependencyProperty 的值是否已設定為繫結。Indicates whether the value of a DependencyProperty is set as a binding. 請參閱 SetBinding(DependencyProperty, ActivityBind)See SetBinding(DependencyProperty, ActivityBind).

(繼承來源 DependencyObject)
MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(繼承來源 Object)
MetaEquals(DependencyObject)

判斷這個 metapropertiesDependencyObjectmetaproperties是否相等於參數化 DependencyObject 的 。Determines whether the metaproperties of this DependencyObject equals the metaproperties of the parameterized DependencyObject.

(繼承來源 DependencyObject)
OnActivityChangeAdd(ActivityExecutionContext, Activity)

加入活動時呼叫。Calls when an activity is added.

(繼承來源 CompositeActivity)
OnActivityChangeRemove(ActivityExecutionContext, Activity)

移除活動時呼叫。Called when an activity is removed.

(繼承來源 CompositeActivity)
OnActivityExecutionContextLoad(IServiceProvider)

每次載入此活動的 ActivityExecutionContext 時,由工作流程執行階段引擎呼叫。Called by the workflow runtime engine every time the ActivityExecutionContext for this activity is loaded.

(繼承來源 CompositeActivity)
OnActivityExecutionContextUnload(IServiceProvider)

每次卸載此活動的 ActivityExecutionContext 時,由工作流程執行階段引擎呼叫。Called by the workflow runtime engine every time the ActivityExecutionContext for this activity is unloaded.

(繼承來源 CompositeActivity)
OnClosed(IServiceProvider)

當活動轉換到已關閉狀態時,由工作流程執行階段呼叫。Called by the workflow runtime as part of the activity's transition to the closed state.

(繼承來源 Activity)
OnListChanged(ActivityCollectionChangeEventArgs)

Activities 屬性變更時,執行額外的處理。Performs additional processing when the Activities property changes.

(繼承來源 CompositeActivity)
OnListChanging(ActivityCollectionChangeEventArgs)

在變更基礎 Activities 之前發生的事件。Event that occurs before a change being made to the underlying Activities.

(繼承來源 CompositeActivity)
OnWorkflowChangesCompleted(ActivityExecutionContext)

在變更這個執行個體的 Activities 集合後呼叫。Called after changes have been made to the collection Activities of this instance.

(繼承來源 CompositeActivity)
RaiseEvent(DependencyProperty, Object, EventArgs)

引發與指定相依性屬性相關聯的 EventRaises an Event associated with the specified dependency property.

(繼承來源 Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)

引發與所參考 DependencyProperty 相關聯的事件。Raises the event associated with the referenced DependencyProperty.

(繼承來源 Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

註冊狀態變更事件的指定 DependencyPropertyRegisters the specified DependencyProperty for the status change event.

(繼承來源 Activity)
RemoveHandler(DependencyProperty, Object)

EventHandler 從相關聯的 DependencyProperty 移除。Removes an EventHandler from an associated DependencyProperty.

(繼承來源 DependencyObject)
RemoveProperty(DependencyProperty)

DependencyPropertyDependencyObject 中移除。Removes a DependencyProperty from the DependencyObject.

(繼承來源 DependencyObject)
Save(Stream)

Activity 寫入保存性 (Persistence) 的 StreamWrites the Activity to a Stream for persistence.

(繼承來源 Activity)
Save(Stream, IFormatter)

使用為序列化提供的自訂 Activity,將 Stream 寫入 IFormatter 以供保存。Writes the Activity to a Stream for persistence using the custom IFormatter provided for serialization.

(繼承來源 Activity)
SetBinding(DependencyProperty, ActivityBind)

設定所指定 ActivityBindDependencyPropertySets 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.

(繼承來源 Activity)
TrackData(Object)

通知執行階段追蹤基礎結構關於暫止追蹤的資訊。Informs the run-time tracking infrastructure of pending tracking information.

(繼承來源 Activity)
TrackData(String, Object)

通知執行階段追蹤基礎結構關於暫止追蹤的資訊。Informs the run-time tracking infrastructure of pending tracking information.

(繼承來源 Activity)
Uninitialize(IServiceProvider)

活動從 Closed 狀態轉換為 Initialized 狀態時,由工作流程執行階段引擎呼叫。Called by the workflow runtime engine when an activity transitions into the Closed state from the Initialized state.

(繼承來源 CompositeActivity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

解除註冊狀態變更事件的指定 DependencyPropertyUn-registers the specified DependencyProperty for the status change event.

(繼承來源 Activity)

事件

Canceling

取消執行活動時發生。Occurs when the activity execution is canceled.

(繼承來源 Activity)
Closed

發生於 Activity 已完成執行時。Occurs when an Activity has completed execution.

(繼承來源 Activity)
Compensating

發生於在 Activity 上執行補償方法時。Occurs when running a compensation method on the Activity.

(繼承來源 Activity)
Executing

發生於執行 Activity 時。Occurs when the Activity is run.

(繼承來源 Activity)
Faulting

在執行個體執行期間引發例外狀況時發生。Occurs when an exception is raised during the running of the instance.

(繼承來源 Activity)
StatusChanged

發生於正在執行之 ActivityExecutionStatusActivity 變更時。Occurs when the ActivityExecutionStatus of a running Activity changes.

(繼承來源 Activity)

明確介面實作

IActivityEventListener<ActivityExecutionStatusChangedEventArgs>.OnEvent(Object, ActivityExecutionStatusChangedEventArgs)

定義活動執行狀態發生變更時的處理程序。Defines the processing procedure when a change the activity execution status occurs.

IComponent.Disposed

表示處理元件 Disposed 事件的方法。Represents the method that handles the Disposed event of a component.

(繼承來源 DependencyObject)

適用於

另請參閱