This documentation is archived and is not being maintained.

ThrowActivity Class

Models the throwing of an exception. This class cannot be inherited.

Namespace:  System.Workflow.ComponentModel
Assembly:  System.Workflow.ComponentModel (in System.Workflow.ComponentModel.dll)

<ToolboxBitmapAttribute(GetType(ThrowActivity), "Resources.Throw.png")> _
Public NotInheritable Class ThrowActivity _
	Inherits Activity _
	Implements ITypeFilterProvider, IDynamicPropertyTypeProvider
Dim instance As ThrowActivity

The purpose of the ThrowActivity is to allow declarative modeling of the throwing of an exception. The ThrowActivity is functionally equivalent to a CodeActivity activity whose code-beside handler throws the indicated exception.

The following code shows the use of a single throw activity in a workflow to implement exception handling. This code example is part of the Throw SDK sample and is from the ThrowWorkflow.cs file. For more information, see Using Throw.

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.Name = "ThrowWorkflow" 
        Me.CanModifyActivities = False 

    End Sub 

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

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

    Private throwActivity1 As ThrowActivity

End Class

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0