ThrowActivity 类

定义

注意

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

对异常的引发进行建模。 此类不能被继承。

public ref class ThrowActivity sealed : System::Workflow::ComponentModel::Activity, System::Workflow::ComponentModel::Design::ITypeFilterProvider, System::Workflow::ComponentModel::IDynamicPropertyTypeProvider
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.ThrowActivity), "Resources.Throw.png")]
public sealed class ThrowActivity : System.Workflow.ComponentModel.Activity, System.Workflow.ComponentModel.Design.ITypeFilterProvider, System.Workflow.ComponentModel.IDynamicPropertyTypeProvider
[System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.ThrowActivity), "Resources.Throw.png")]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class ThrowActivity : System.Workflow.ComponentModel.Activity, System.Workflow.ComponentModel.Design.ITypeFilterProvider, System.Workflow.ComponentModel.IDynamicPropertyTypeProvider
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.ThrowActivity), "Resources.Throw.png")>]
type ThrowActivity = class
    inherit Activity
    interface ITypeFilterProvider
    interface IDynamicPropertyTypeProvider
[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.ThrowActivity), "Resources.Throw.png")>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type ThrowActivity = class
    inherit Activity
    interface ITypeFilterProvider
    interface IDynamicPropertyTypeProvider
Public NotInheritable Class ThrowActivity
Inherits Activity
Implements IDynamicPropertyTypeProvider, ITypeFilterProvider
继承
属性
实现

示例

下面的代码演示在工作流中使用单个引发活动来实现异常处理。 此代码示例摘自 ThrowWorkflow.cs 文件中的“引发 SDK”示例。 有关详细信息,请参阅 使用引发

public sealed partial class ThrowWorkflow : SequentialWorkflowActivity
{
    [System.Diagnostics.DebuggerNonUserCode()]
    private void InitializeComponent()
    {
        this.CanModifyActivities = true;
        System.Workflow.ComponentModel.ActivityBind activitybind1 = new System.Workflow.ComponentModel.ActivityBind();
        this.throwActivity1 = new System.Workflow.ComponentModel.ThrowActivity();
        activitybind1.Name = "ThrowWorkflow";
        activitybind1.Path = "ThrownException";
        //
        // throwActivity1
        //
        this.throwActivity1.Name = "throwActivity1";
        this.throwActivity1.SetBinding(System.Workflow.ComponentModel.ThrowActivity.FaultProperty, ((System.Workflow.ComponentModel.ActivityBind)(activitybind1)));
        //
        // ThrowWorkflow
        //
        this.Activities.Add(this.throwActivity1);
        this.Name = "ThrowWorkflow";
        this.CanModifyActivities = false;
    }

    private Exception thrownExceptionValue = new System.Exception("My Exception Message.");

    public Exception ThrownException
    {
        get { return thrownExceptionValue; }
        set { thrownExceptionValue = value; }
    }

    private ThrowActivity throwActivity1;
}
Partial Public NotInheritable Class ThrowWorkflow
    Inherits SequentialWorkflowActivity

    <System.Diagnostics.DebuggerNonUserCode()> _
                                        Private Sub InitializeComponent()

        Me.CanModifyActivities = True
        Dim activitybind1 As New System.Workflow.ComponentModel.ActivityBind()
        Me.throwActivity1 = New System.Workflow.ComponentModel.ThrowActivity()
        activitybind1.Name = "ThrowWorkflow"
        activitybind1.Path = "ThrownException"
        ' 
        ' throwActivity1
        ' 
        Me.throwActivity1.Name = "throwActivity1"
        Me.throwActivity1.SetBinding(System.Workflow.ComponentModel.ThrowActivity.FaultProperty, activitybind1)
        ' 
        ' ThrowWorkflow
        ' 
        Me.Activities.Add(Me.throwActivity1)
        Me.Name = "ThrowWorkflow"
        Me.CanModifyActivities = False

    End Sub

    Private thrownExceptionValue As New System.Exception("My Exception Message.")

    Public Property ThrownException() As Exception
        Get
            Return thrownExceptionValue
        End Get
        Set(ByVal value As Exception)
            thrownExceptionValue = value
        End Set
    End Property

    Private throwActivity1 As ThrowActivity

End Class

注解

备注

本材料讨论的类型和命名空间已废弃不用。 有关详细信息,请参阅 Windows Workflow Foundation 4.5 中弃用的类型

ThrowActivity 的目的是允许对引发异常进行声明性建模。 ThrowActivity 的功能等同于其代码旁置处理程序引发了指示的异常的 CodeActivity 活动。

构造函数

ThrowActivity()

初始化 ThrowActivity 类的新实例。

ThrowActivity(String)

初始化 ThrowActivity 类的新实例,并初始化其名称。

字段

FaultProperty

表示此实例的 DependencyProperty 属性的 Fault

FaultTypeProperty

表示此实例的 DependencyProperty 属性的 FaultType

属性

Description

获取或设置 Activity 的用户定义说明。

(继承自 Activity)
DesignMode

获取一个值,该值指示此实例是处于设计模式还是运行时模式。

(继承自 DependencyObject)
Enabled

获取或设置一个值,该值指示是否启用此实例以供执行和验证。

(继承自 Activity)
ExecutionResult

获取最后一次尝试运行此实例产生的 ActivityExecutionResult

(继承自 Activity)
ExecutionStatus

获取此实例的当前 ActivityExecutionStatus

(继承自 Activity)
Fault

获取或设置由 ThrowActivity 调用的异常对象。

FaultType

获取或设置由 ThrowActivity 调用的执行的类型。

IsDynamicActivity

获取有关活动是否在工作流实例的默认 ActivityExecutionContext 中执行的信息。

(继承自 Activity)
Name

获取或设置此实例的名称。 此名称必须符合工作流项目中使用的编程语言的变量命名规则。

(继承自 Activity)
Parent

获取包含此 CompositeActivityActivity

(继承自 Activity)
ParentDependencyObject

获取 DependencyObject 图中的父 DependencyObject

(继承自 DependencyObject)
QualifiedName

获取活动的限定名。 活动的限定名在工作流实例中始终是唯一的。

(继承自 Activity)
Site

获取或设置对 SiteDependencyObject 组件的引用。

(继承自 DependencyObject)
UserData

获取一个 IDictionary,它将自定义数据与此类实例关联。

(继承自 DependencyObject)
WorkflowInstanceId

获取与实例关联的 Guid

(继承自 Activity)

方法

AddHandler(DependencyProperty, Object)

DependencyObject 的事件添加处理程序。

(继承自 DependencyObject)
Cancel(ActivityExecutionContext)

由工作流运行时调用,用于取消当前正在运行的活动执行。

(继承自 Activity)
Clone()

创建 Activity 的深层副本。

(继承自 Activity)
Dispose()

释放由 DependencyObject 占用的所有资源。

(继承自 DependencyObject)
Dispose(Boolean)

释放非托管资源,还可以释放由 DependencyObject 占用的托管资源。

(继承自 DependencyObject)
Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
Execute(ActivityExecutionContext)

由工作流运行时调用,用于执行活动。

(继承自 Activity)
GetActivityByName(String)

返回 Activity 的实例,其名称由此实例的根活动下(即在工作流中)运行的所有活动的集请求。

(继承自 Activity)
GetActivityByName(String, Boolean)

返回 Activity 的实例,其名称被此实例的根 Activity 下的所有活动的集(如果第二个参数为 false)和当前 Activity 下的所有活动的集(如果第二个参数为 true)请求。

(继承自 Activity)
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)

此实例的执行上下文中引发了异常时调用。

(继承自 Activity)
Initialize(IServiceProvider)

由工作流运行时调用,用于在构造新的工作流实例期间初始化活动。 此方法在构造动态 ActivityExecutionContext 期间调用。

(继承自 Activity)
InitializeProperties()

在派生类中重写时,对依赖属性执行初始化。

(继承自 DependencyObject)
Invoke<T>(EventHandler<T>, T)

订阅 EventHandler 并调用该委托。

(继承自 Activity)
Invoke<T>(IActivityEventListener<T>, T)

订阅 IActivityEventListener<T> 并调用该委托。

(继承自 Activity)
IsBindingSet(DependencyProperty)

指示 DependencyProperty 的值是否设置为绑定。 请参阅 SetBinding(DependencyProperty, ActivityBind)

(继承自 DependencyObject)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
MetaEquals(DependencyObject)

确定此 metapropertiesDependencyObject 是否等于参数化的 metapropertiesDependencyObject

(继承自 DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

每当加载 ActivityExecutionContext 时,由工作流运行时调用。 例如,在创建 ActivityExecutionContext 期间,以及每次在从持久性存储区中加载工作流实例期间重建 ActivityExecutionContext 时,会调用此方法。

(继承自 Activity)
OnActivityExecutionContextUnload(IServiceProvider)

每当卸载 ActivityExecutionContext 时,由工作流运行时调用。 例如,在完成 ActivityExecutionContext 期间,以及每次在保留工作流实例期间卸载 ActivityExecutionContext 时,会调用此方法。

(继承自 Activity)
OnClosed(IServiceProvider)

作为活动向 Closed 状态转换的一部分,由工作流运行时调用。

(继承自 Activity)
RaiseEvent(DependencyProperty, Object, EventArgs)

引发与指定依赖属性关联的 Event

(继承自 Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)

引发与引用的 DependencyProperty 关联的事件。

(继承自 Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

为状态更改事件注册指定的 DependencyProperty

(继承自 Activity)
RemoveHandler(DependencyProperty, Object)

从关联的 EventHandler 中移除 DependencyProperty

(继承自 DependencyObject)
RemoveProperty(DependencyProperty)

DependencyProperty 中移除 DependencyObject

(继承自 DependencyObject)
Save(Stream)

Activity 写入到 Stream 以便进行保留。

(继承自 Activity)
Save(Stream, IFormatter)

使用为序列化提供的自定义 ActivityStream 写入到 IFormatter,以便进行保留。

(继承自 Activity)
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()

提供表示此实例的字符串。

(继承自 Activity)
TrackData(Object)

向运行时跟踪基础结构通知有关挂起跟踪的信息。

(继承自 Activity)
TrackData(String, Object)

向运行时跟踪基础结构通知有关挂起跟踪的信息。

(继承自 Activity)
Uninitialize(IServiceProvider)

当在派生类中重写时,为活动提供由服务提供程序执行的反初始化。

(继承自 Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

注销状态更改事件的指定 DependencyProperty

(继承自 Activity)

事件

Canceling

在取消活动执行时发生。

(继承自 Activity)
Closed

Activity 完成执行时发生。

(继承自 Activity)
Compensating

Activity 上运行补偿方法时发生。

(继承自 Activity)
Executing

在运行 Activity 时发生。

(继承自 Activity)
Faulting

在实例的运行期间引发异常时发生。

(继承自 Activity)
StatusChanged

在运行中的 ActivityExecutionStatusActivity 更改时发生。

(继承自 Activity)

显式接口实现

IComponent.Disposed

表示处理组件的“Disposed”事件的方法。

(继承自 DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)

返回指定属性的访问类型。

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)

返回指定属性的 Type

ITypeFilterProvider.CanFilterType(Type, Boolean)

返回一个值,该值指示能否筛选指定的 Type

ITypeFilterProvider.FilterDescription

获取要在类浏览器对话框中显示的筛选器的说明。

适用于