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
Наследование
Атрибуты
Реализации

Примеры

В следующем примере кода показано использование одного действия создания исключения в рабочем процессе, чтобы реализовать обработку исключений. Данный пример кода является частью примера SDK "Throw" из файла ThrowWorkflow.cs. Дополнительные сведения см. в разделе "Использование throw".

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

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

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

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

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

Возвращает полное имя действия. Полные имена действий всегда уникальны в рамках экземпляра рабочего процесса.

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

Возвращает или задает ссылку на компонент Site объекта DependencyObject.

(Унаследовано от 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)

Определяет, совпадают ли свойства metaproperties этого объекта DependencyObject со свойствами metaproperties параметризованного объекта DependencyObject.

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

Вызывается средой выполнения рабочих процессов при каждой загрузке объекта ActivityExecutionContext. Например, этот метод вызывается во время создания объекта ActivityExecutionContext, а также при каждом повторном воплощении объекта ActivityExecutionContext во время загрузки экземпляра рабочего процесса из постоянного хранилища.

(Унаследовано от Activity)
OnActivityExecutionContextUnload(IServiceProvider)

Вызывается средой выполнения рабочих процессов каждый раз, как выгружается объект ActivityExecutionContext. Например, этот метод вызывается во время завершения ActivityExecutionContext, а также каждый раз при выгрузке объекта ActivityExecutionContext, если экземпляр рабочего процесса сохраняется.

(Унаследовано от Activity)
OnClosed(IServiceProvider)

Вызывается средой выполнения рабочих процессов и является частью перехода действия в закрытое состояние.

(Унаследовано от 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)

Записывает действие Activity в объект Stream для сохранения, применяя пользовательский интерфейс 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

Происходит при изменении состояния ActivityExecutionStatus действия Activity.

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

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

IComponent.Disposed

Представляет метод, обрабатывающий событие Disposed компонента.

(Унаследовано от DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)

Возвращает тип доступа для заданного свойства.

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)

Возвращает тип Type заданного свойства.

ITypeFilterProvider.CanFilterType(Type, Boolean)

Возвращает значение, указывающее, можно ли фильтровать указанный тип Type.

ITypeFilterProvider.FilterDescription

Возвращает описание фильтра, который будет выведен в диалоговом окне браузера классов.

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