ThrowActivity Classe

Definizione

Spazio dei nomi:

System.Workflow.ComponentModel

Assembly:

System.Workflow.ComponentModel.dll

Attenzione

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

Modella la generazione di un'eccezione. La classe non può essere ereditata.

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")]
[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")>]
[<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

Ereditarietà

Object

DependencyObject

Activity

ThrowActivity

Attributi

ToolboxBitmapAttribute ObsoleteAttribute

Implementazioni

ITypeFilterProvider IDynamicPropertyTypeProvider

Esempio

Nel codice seguente è mostrato l'utilizzo di un’attività di generazione di eccezioni in un flusso di lavoro per implementare la gestione delle eccezioni. Questo esempio di codice è parte dell'esempio SDK Throw e si trova nel file ThrowWorkflow.cs. Per altre informazioni, vedere Uso di 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

Commenti

Nota

In questo materiale vengono descritti tipi e spazi dei nomi obsoleti. Per altre informazioni, vedere Deprecated Types in Windows Workflow Foundation 4.5 (Tipi deprecati in Windows Workflow Foundation 4.5).

Lo scopo della classe ThrowActivity è di consentire l’utilizzo di modelli dichiarativi per la generazione di un'eccezione. ThrowActivity è equivalente in funzionalità a un'attività CodeActivity il cui gestore code-beside genera l'eccezione indicata.

Costruttori

ThrowActivity()	Obsoleti. Inizializza una nuova istanza della classe ThrowActivity.
ThrowActivity(String)	Obsoleti. Inizializza una nuova istanza della classe ThrowActivity e ne inizializza il nome.

Campi

FaultProperty	Obsoleti. DependencyProperty che rappresenta la proprietà Fault dell’istanza.
FaultTypeProperty	Obsoleti. DependencyProperty che rappresenta la proprietà FaultType dell’istanza.

Proprietà

Description	Obsoleti. Ottiene o imposta la descrizione definita dall'utente dell'oggetto Activity. (Ereditato da Activity)
DesignMode	Obsoleti. Ottiene il valore che indica se l’istanza è in modalità di progettazione o esecuzione. (Ereditato da DependencyObject)
Enabled	Obsoleti. Ottiene o imposta un valore che indica se l'istanza è abilitata per l'esecuzione e la convalida. (Ereditato da Activity)
ExecutionResult	Obsoleti. Ottiene l’enumerazione ActivityExecutionResult dell’ultimo tentativo di esecuzione dell’istanza. (Ereditato da Activity)
ExecutionStatus	Obsoleti. Ottiene lo stato corrente ActivityExecutionStatus dell’istanza. (Ereditato da Activity)
Fault	Obsoleti. Ottiene o imposta l'oggetto di eccezione che deve essere generato da ThrowActivity.
FaultType	Obsoleti. Ottiene o imposta il tipo di eccezione che deve essere generato da ThrowActivity.
IsDynamicActivity	Obsoleti. Ottiene informazioni che indicano se l'attività è in esecuzione o meno all'interno dell'oggetto ActivityExecutionContext predefinito dell'istanza del flusso di lavoro. (Ereditato da Activity)
Name	Obsoleti. Ottiene o imposta il nome dell'istanza. Questo nome deve essere conforme alle convenzioni di denominazione delle variabili per il linguaggio di programmazione che si sta utilizzando nel progetto di flusso di lavoro. (Ereditato da Activity)
Parent	Obsoleti. Ottiene l'oggetto CompositeActivity che contiene questo Activity. (Ereditato da Activity)
ParentDependencyObject	Obsoleti. Ottiene l’oggetto DependencyObject padre nel grafico di DependencyObject. (Ereditato da DependencyObject)
QualifiedName	Obsoleti. Ottiene il nome completo dell’attività. In un'istanza del flusso di lavoro, i nomi completi di attività sono sempre univoci. (Ereditato da Activity)
Site	Obsoleti. Ottiene o imposta un riferimento al componente Site di DependencyObject. (Ereditato da DependencyObject)
UserData	Obsoleti. Ottiene un’interfaccia IDictionary che associa dati personalizzati a questa istanza della classe. (Ereditato da DependencyObject)
WorkflowInstanceId	Obsoleti. Ottiene l’identificativo Guid associato all’istanza. (Ereditato da Activity)

Metodi

AddHandler(DependencyProperty, Object)	Obsoleti. Aggiunge un gestore per un evento di una classe DependencyObject. (Ereditato da DependencyObject)
Cancel(ActivityExecutionContext)	Obsoleti. Chiamata dal runtime del flusso di lavoro per annullare l’esecuzione di un'attività attualmente in esecuzione. (Ereditato da Activity)
Clone()	Obsoleti. Crea una copia completa della classe Activity. (Ereditato da Activity)
Dispose()	Obsoleti. Libera tutte le risorse utilizzate dall'oggetto DependencyObject. (Ereditato da DependencyObject)
Dispose(Boolean)	Obsoleti. Libera le risorse non gestite utilizzate dall’oggetto DependencyObject ed eventualmente le risorse gestite. (Ereditato da DependencyObject)
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Execute(ActivityExecutionContext)	Obsoleti. Chiamato dal runtime del flusso di lavoro per eseguire un'attività. (Ereditato da Activity)
GetActivityByName(String)	Obsoleti. Restituisce l'istanza dell'oggetto Activity, il cui nome viene richiesto dal set di tutte le attività in esecuzione nell'attività radice di questa istanza che si trova all'interno del flusso di lavoro. (Ereditato da Activity)
GetActivityByName(String, Boolean)	Obsoleti. Restituisce l’istanza di Activity il cui nome viene richiesto dal set di tutte le attività sotto la classe radice Activity di questa istanza, se il secondo parametro è false e sotto la classe Activity corrente se il secondo parametro è true. (Ereditato da Activity)
GetBinding(DependencyProperty)	Obsoleti. Fornisce l’accesso alla classe ActivityBind associata alla classe DependencyProperty specifica. (Ereditato da DependencyObject)
GetBoundValue(ActivityBind, Type)	Obsoleti. Recupera l'oggetto Object che corrisponde al soggetto di una classe ActivityBind. (Ereditato da DependencyObject)
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetInvocationList<T>(DependencyProperty)	Obsoleti. Ottiene una matrice che contiene i delegati per la classe DependencyProperty specificata. (Ereditato da DependencyObject)
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Obsoleti. Fornisce l’accesso al valore della classe DependencyProperty designata. (Ereditato da DependencyObject)
GetValueBase(DependencyProperty)	Obsoleti. Fornisce l’accesso all’oggetto associato di una classe DependencyProperty, ignorando l’override di GetValue(DependencyProperty). (Ereditato da DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	Obsoleti. Chiamato quando all'interno del contesto di esecuzione di questa istanza viene generata un'eccezione. (Ereditato da Activity)
Initialize(IServiceProvider)	Obsoleti. Chiamata dal runtime del flusso di lavoro per inizializzare un'attività durante la costruzione di una nuova istanza del flusso di lavoro. Il metodo viene chiamato durante la costruzione di un ActivityExecutionContext dinamico. (Ereditato da Activity)
InitializeProperties()	Obsoleti. Esegue l’inizializzazione sulle proprietà di dipendenza quando ne viene eseguito l’override in una classe derivata. (Ereditato da DependencyObject)
Invoke<T>(EventHandler<T>, T)	Obsoleti. Sottoscrive un EventHandler e richiama il delegato. (Ereditato da Activity)
Invoke<T>(IActivityEventListener<T>, T)	Obsoleti. Sottoscrive un IActivityEventListener<T> e richiama il delegato. (Ereditato da Activity)
IsBindingSet(DependencyProperty)	Obsoleti. Indica se il valore di DependencyProperty è impostato come un'associazione. Vedere SetBinding(DependencyProperty, ActivityBind). (Ereditato da DependencyObject)
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MetaEquals(DependencyObject)	Obsoleti. Determina se le metaproperties di DependencyObject sono uguali alle metaproperties della classe DependencyObject parametrizzata. (Ereditato da DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	Obsoleti. Chiamato dal runtime del flusso di lavoro quando viene caricato il contesto ActivityExecutionContext. Ad esempio, questo metodo viene chiamato sia durante la creazione di un ActivityExecutionContext sia ogni volta che ActivityExecutionContext viene ricreato al momento di caricare un’istanza del flusso di lavoro da un’archiviazione persistente. (Ereditato da Activity)
OnActivityExecutionContextUnload(IServiceProvider)	Obsoleti. Chiamato dal runtime del flusso di lavoro quando viene scaricato il contesto ActivityExecutionContext. Ad esempio, questo metodo viene chiamato sia durante il completamento di un ActivityExecutionContext sia ogni volta che ActivityExecutionContext viene scaricato al momento di rendere persistente un’istanza del flusso di lavoro. (Ereditato da Activity)
OnClosed(IServiceProvider)	Obsoleti. Chiamato dal motore di runtime del flusso di lavoro come parte della transizione dell'attività allo stato chiuso. (Ereditato da Activity)
RaiseEvent(DependencyProperty, Object, EventArgs)	Obsoleti. Genera un evento Event associato alla proprietà di dipendenza specificata. (Ereditato da Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)	Obsoleti. Genera l’evento associato alla proprietà DependencyProperty a cui si fa riferimento. (Ereditato da Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleti. Registra la proprietà specificata DependencyProperty relativamente all’evento di modifica dello stato. (Ereditato da Activity)
RemoveHandler(DependencyProperty, Object)	Obsoleti. Rimuove un elemento EventHandler dalla classe DependencyProperty associata. (Ereditato da DependencyObject)
RemoveProperty(DependencyProperty)	Obsoleti. Rimuove una classe DependencyProperty dalla classe DependencyObject. (Ereditato da DependencyObject)
Save(Stream)	Obsoleti. Scrive la classe Activity in una classe Stream per la persistenza. (Ereditato da Activity)
Save(Stream, IFormatter)	Obsoleti. Scrive Activity in una classe Stream per la persistenza utilizzando l’interfaccia IFormatter personalizzata fornita per la serializzazione. (Ereditato da Activity)
SetBinding(DependencyProperty, ActivityBind)	Obsoleti. Imposta ActivityBind per la classe DependencyProperty specificata. (Ereditato da DependencyObject)
SetBoundValue(ActivityBind, Object)	Obsoleti. Imposta il valore della classe ActivityBind di destinazione. (Ereditato da DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	Obsoleti. Imposta il valore di DependencyProperty in sola lettura. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Obsoleti. Imposta il valore di DependencyProperty sull’oggetto. (Ereditato da DependencyObject)
SetValueBase(DependencyProperty, Object)	Obsoleti. Imposta il valore della classe DependencyProperty all’oggetto Object specificato, ignorando SetValue(DependencyProperty, Object). (Ereditato da DependencyObject)
ToString()	Obsoleti. Fornisce una stringa che rappresenta l'istanza. (Ereditato da Activity)
TrackData(Object)	Obsoleti. Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso. (Ereditato da Activity)
TrackData(String, Object)	Obsoleti. Informa l'infrastruttura di controllo di runtime sulle informazioni di rilevamento in sospeso. (Ereditato da Activity)
Uninitialize(IServiceProvider)	Obsoleti. Quando viene eseguito l'override in una classe derivata, fornisce la non inizializzazione mediante un provider di servizi per l'attività. (Ereditato da Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	Obsoleti. Annulla la registrazione della proprietà specificata DependencyProperty per l’evento di modifica dello stato. (Ereditato da Activity)

Eventi

Canceling	Obsoleti. Si verifica quando l'esecuzione dell’attività è annullata. (Ereditato da Activity)
Closed	Obsoleti. Si verifica quando viene completata l'esecuzione di Activity. (Ereditato da Activity)
Compensating	Obsoleti. Si verifica in caso dell'esecuzione di un metodo di compensazione su Activity. (Ereditato da Activity)
Executing	Obsoleti. Si verifica quando viene eseguita la classe Activity. (Ereditato da Activity)
Faulting	Obsoleti. Si verifica quando viene generata un'eccezione durante l’esecuzione dell'istanza. (Ereditato da Activity)
StatusChanged	Obsoleti. Si verifica quando viene modificato lo stato ActivityExecutionStatus di una classe Activity in esecuzione. (Ereditato da Activity)

Implementazioni dell'interfaccia esplicita

IComponent.Disposed	Obsoleti. Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)	Obsoleti. Restituisce il tipo di accesso per la proprietà specificata.
IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)	Obsoleti. Restituisce l'oggetto Type della proprietà specificata.
ITypeFilterProvider.CanFilterType(Type, Boolean)	Obsoleti. Restituisce un valore che indica se è possibile filtrare Type.
ITypeFilterProvider.FilterDescription	Obsoleti. Ottiene la descrizione per il filtro da visualizzare nella finestra di dialogo del browser di classi.