Partager via


ThrowActivity Classe

Définition

Attention

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

Modélise la levée d'une exception. Cette classe ne peut pas être héritée.

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
Héritage
Attributs
Implémente

Exemples

Le code suivant montre l'utilisation d'une activité de levée unique dans un workflow pour implémenter la gestion des exceptions. Cet exemple de code fait partie de l'exemple du Kit de développement logiciel (SDK) Throw et provient du fichier ThrowWorkflow.cs. Pour plus d’informations, consultez Utilisation de 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

Remarques

Notes

Ce document décrit les types et les espaces de noms qui sont obsolètes. Pour plus d’informations, consultez Types dépréciés dans Windows Workflow Foundation 4.5.

Le but de ThrowActivity est d'autoriser une modélisation déclarative de la levée d'une exception. ThrowActivity est équivalent sur le plan fonctionnel à une activité CodeActivity dont le gestionnaire code-beside lève l'exception indiquée.

Constructeurs

ThrowActivity()

Initialise une nouvelle instance de la classe ThrowActivity.

ThrowActivity(String)

Initialise une nouvelle instance de la classe ThrowActivity, ainsi que son nom.

Champs

FaultProperty

DependencyProperty représentant la propriété Fault de cette instance.

FaultTypeProperty

DependencyProperty représentant la propriété FaultType de cette instance.

Propriétés

Description

Obtient ou définit la description définie par l'utilisateur du Activity.

(Hérité de Activity)
DesignMode

Obtient la valeur qui indique si cette instance est en mode Création ou Exécution.

(Hérité de DependencyObject)
Enabled

Obtient ou définit une valeur qui indique si cette instance est activée pour l’exécution et la validation.

(Hérité de Activity)
ExecutionResult

Obtient le ActivityExecutionResult de la dernière tentative d'exécution de cette instance.

(Hérité de Activity)
ExecutionStatus

Obtient le ActivityExecutionStatus actuel de cette instance.

(Hérité de Activity)
Fault

Obtient ou définit l'objet d'exception qui doit être levé par l'ThrowActivity.

FaultType

Obtient ou définit le type d'exception qui doit être levé par l'ThrowActivity.

IsDynamicActivity

Obtient des informations sur l'exécution de l'activité dans le ActivityExecutionContext par défaut de l'instance de workflow.

(Hérité de Activity)
Name

Obtient ou définit le nom de cette instance. Ce nom doit se conformer à la convention d'affectation des noms variables du langage de programmation utilisé dans le projet de workflow.

(Hérité de Activity)
Parent

Obtient le CompositeActivity qui contient ce Activity.

(Hérité de Activity)
ParentDependencyObject

Obtient le DependencyObject parent dans le graphique DependencyObject.

(Hérité de DependencyObject)
QualifiedName

Obtient le nom qualifié de l'activité. Les noms qualifiés d'activité sont toujours uniques dans une instance de workflow.

(Hérité de Activity)
Site

Obtient ou définit une référence au composant Site de DependencyObject.

(Hérité de DependencyObject)
UserData

Obtient un IDictionary qui associe des données personnalisées à cette instance de classe.

(Hérité de DependencyObject)
WorkflowInstanceId

Obtient le Guid associé à l'instance.

(Hérité de Activity)

Méthodes

AddHandler(DependencyProperty, Object)

Ajoute un gestionnaire pour un événement d'un DependencyObject.

(Hérité de DependencyObject)
Cancel(ActivityExecutionContext)

Appelé par l'exécution du workflow pour annuler celle d'une activité en cours.

(Hérité de Activity)
Clone()

Crée une copie complète de Activity.

(Hérité de Activity)
Dispose()

Libère toutes les ressources utilisées par DependencyObject.

(Hérité de DependencyObject)
Dispose(Boolean)

Libère les ressources non managées et éventuellement les ressources managées utilisées par DependencyObject.

(Hérité de DependencyObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Execute(ActivityExecutionContext)

Appelé par l'exécution du workflow pour exécuter une activité.

(Hérité de Activity)
GetActivityByName(String)

Retourne l'instance du Activity dont le nom est demandé à l'ensemble des activités s'exécutant sous l'activité racine de cette instance, c'est-à-dire au sein du workflow.

(Hérité de Activity)
GetActivityByName(String, Boolean)

Retourne l'instance du Activity dont le nom est demandé à l'ensemble des activités sous la racine du Activity de cette instance si le deuxième paramètre est false et sous le Activity actuel si le deuxième paramètre est true.

(Hérité de Activity)
GetBinding(DependencyProperty)

Fournit l'accès au ActivityBind associé au DependencyProperty spécifique.

(Hérité de DependencyObject)
GetBoundValue(ActivityBind, Type)

Récupère le Object qui est le sujet d'un ActivityBind.

(Hérité de DependencyObject)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetInvocationList<T>(DependencyProperty)

Obtient un tableau qui contient les délégués du DependencyProperty spécifié.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetValue(DependencyProperty)

Fournit l'accès à la valeur du DependencyProperty désigné.

(Hérité de DependencyObject)
GetValueBase(DependencyProperty)

Fournit l'accès à l'objet lié d'un objet DependencyProperty et contourne la substitution GetValue(DependencyProperty).

(Hérité de DependencyObject)
HandleFault(ActivityExecutionContext, Exception)

Appelée lorsqu'une exception est levée dans le contexte de l'exécution de cette instance.

(Hérité de Activity)
Initialize(IServiceProvider)

Appelé par l'exécution du workflow pour initialiser une activité pendant la construction d'une nouvelle instance de workflow. Cette méthode est appelée pendant la construction d'un ActivityExecutionContext dynamique.

(Hérité de Activity)
InitializeProperties()

Exécute l'initialisation des propriétés de dépendance en cas de substitution dans une classe dérivée.

(Hérité de DependencyObject)
Invoke<T>(EventHandler<T>, T)

Souscrit un EventHandler et appelle ce délégué.

(Hérité de Activity)
Invoke<T>(IActivityEventListener<T>, T)

Souscrit un IActivityEventListener<T> et appelle ce délégué.

(Hérité de Activity)
IsBindingSet(DependencyProperty)

Indique si la valeur d'un objet DependencyProperty est définie comme liaison. Consultez SetBinding(DependencyProperty, ActivityBind).

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MetaEquals(DependencyObject)

Détermine si le metaproperties de ce DependencyObject est égal au metaproperties du DependencyObject paramétré.

(Hérité de DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)

Appelé par l'exécution du workflow chaque fois qu'un ActivityExecutionContext est chargé. Par exemple, cette méthode est appelée pendant la création d'un ActivityExecutionContext, ainsi que chaque fois que ActivityExecutionContext est réincarné lorsqu'une instance de workflow est chargée à partir d'un stockage persistant.

(Hérité de Activity)
OnActivityExecutionContextUnload(IServiceProvider)

Appelé par l'exécution du workflow chaque fois qu'un ActivityExecutionContext est déchargé. Par exemple, cette méthode est appelée à la fin d'un ActivityExecutionContext, ainsi que chaque fois que ActivityExecutionContext est déchargé lorsqu'une instance de workflow est rendue persistante.

(Hérité de Activity)
OnClosed(IServiceProvider)

Appelé par l'exécution du workflow dans le cadre du passage de l'activité à l'état Fermé.

(Hérité de Activity)
RaiseEvent(DependencyProperty, Object, EventArgs)

Déclenche un Event associé à la propriété de dépendance spécifiée.

(Hérité de Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)

Déclenche l'événement associé au DependencyProperty référencé.

(Hérité de Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Inscrit le DependencyProperty spécifié pour l'événement de modification de l'état.

(Hérité de Activity)
RemoveHandler(DependencyProperty, Object)

Supprime un EventHandler d'un DependencyProperty associé.

(Hérité de DependencyObject)
RemoveProperty(DependencyProperty)

Supprime un DependencyProperty de DependencyObject.

(Hérité de DependencyObject)
Save(Stream)

Écrit le Activity sur un Stream pour la persistence.

(Hérité de Activity)
Save(Stream, IFormatter)

Écrit le Activity sur un Stream pour la persistance à l'aide du IFormatter personnalisé fourni pour la sérialisation.

(Hérité de Activity)
SetBinding(DependencyProperty, ActivityBind)

Définit le ActivityBind du DependencyProperty spécifié.

(Hérité de DependencyObject)
SetBoundValue(ActivityBind, Object)

Définit la valeur du ActivityBind cible.

(Hérité de DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)

Définit la valeur d'un objet DependencyProperty, qui est en lecture seule.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Attribue la valeur DependencyProperty à l'objet.

(Hérité de DependencyObject)
SetValueBase(DependencyProperty, Object)

Attribue la valeur de DependencyProperty au Object spécifié, en ignorant SetValue(DependencyProperty, Object).

(Hérité de DependencyObject)
ToString()

Fournit une chaîne représentant cette instance.

(Hérité de Activity)
TrackData(Object)

Informe l'infrastructure de suivi de l'exécution d'informations de suivi en attente.

(Hérité de Activity)
TrackData(String, Object)

Informe l'infrastructure de suivi de l'exécution d'informations de suivi en attente.

(Hérité de Activity)
Uninitialize(IServiceProvider)

En cas de substitution dans une classe dérivée, fournit une désinitialisation par un fournisseur de services pour l'activité.

(Hérité de Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)

Désinscrit le DependencyProperty spécifié pour l'événement de modification de l'état.

(Hérité de Activity)

Événements

Canceling

Se produit lorsque l'exécution de l'activité est annulée.

(Hérité de Activity)
Closed

Se produit lorsque l'exécution d'un Activity est terminée.

(Hérité de Activity)
Compensating

Se produit lors de l'exécution d'une méthode de compensation sur Activity.

(Hérité de Activity)
Executing

Se produit lors de l'exécution de Activity.

(Hérité de Activity)
Faulting

Se produit lorsqu'une exception est déclenchée durant l'exécution de l'instance.

(Hérité de Activity)
StatusChanged

Se produit lors de la modification du ActivityExecutionStatus d'un Activity en cours d'exécution.

(Hérité de Activity)

Implémentations d’interfaces explicites

IComponent.Disposed

Représente la méthode qui gère l’événement Disposed d’un composant.

(Hérité de DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)

Retourne le type d'accès pour la propriété spécifiée.

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)

Renvoie le Type de la propriété spécifiée.

ITypeFilterProvider.CanFilterType(Type, Boolean)

Retourne une valeur qui indique si le Type spécifié peut être filtré.

ITypeFilterProvider.FilterDescription

Obtient la description du filtre à afficher dans la boîte de dialogue de l'explorateur de classes.

S’applique à