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