ThrowActivity Класс

Ссылка

Определение

Пространство имен:: System.Workflow.ComponentModel

Сборка:: System.Workflow.ComponentModel.dll

Важно!

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

Внимание!

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

Наследование: Object

DependencyObject

Activity
ThrowActivity

Атрибуты: ToolboxBitmapAttribute ObsoleteAttribute

Реализации: ITypeFilterProvider IDynamicPropertyTypeProvider

Примеры

В следующем примере кода показано использование одного действия создания исключения в рабочем процессе, чтобы реализовать обработку исключений. Данный пример кода является частью примера 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

Назначение класса 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	Возвращает описание фильтра, который будет выведен в диалоговом окне браузера классов.

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

Share via