Freigeben über


ThrowActivity Klasse

Definition

Achtung

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

Stellt das Auslösen einer Ausnahme im Modell dar. Diese Klasse kann nicht vererbt werden.

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
Vererbung
Attribute
Implementiert

Beispiele

Der folgende Code beschreibt die Verwendung einer einzelnen Auslöseaktivität in einem Workflow für die Implementierung der Ausnahmebehandlung. Dieses Codebeispiel stammt aus dem Throw SDK-Beispiel in der Datei ThrowWorkFlow.cs. Weitere Informationen finden Sie unter Verwenden von 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

Hinweise

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.

ThrowActivity dient dazu, die deklarative Modellerstellung für das Auslösen einer Ausnahme zuzulassen. ThrowActivity entspricht hinsichtlich der Funktionen einer CodeActivity-Aktivität, von deren Code-Beside-Handler die angegebene Ausnahme ausgelöst wird.

Konstruktoren

ThrowActivity()
Veraltet.

Initialisiert eine neue Instanz der ThrowActivity-Klasse.

ThrowActivity(String)
Veraltet.

Initialisiert eine neue Instanz der ThrowActivity-Klasse und initialisiert deren Namen.

Felder

FaultProperty
Veraltet.

Die DependencyProperty, die die Fault-Eigenschaft für diese Instanz darstellt.

FaultTypeProperty
Veraltet.

Die DependencyProperty, die die FaultType-Eigenschaft für diese Instanz darstellt.

Eigenschaften

Description
Veraltet.

Ruft die benutzerdefinierte Beschreibung von Activity ab oder legt sie fest.

(Geerbt von Activity)
DesignMode
Veraltet.

Ruft den Wert ab, der angibt, ob sich diese Instanz im Entwurfs- oder Laufzeitmodus befindet.

(Geerbt von DependencyObject)
Enabled
Veraltet.

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob diese Instanz zur Ausführung und Validierung aktiviert ist.

(Geerbt von Activity)
ExecutionResult
Veraltet.

Ruft das ActivityExecutionResult des letzten Versuchs zur Ausführung dieser Instanz ab.

(Geerbt von Activity)
ExecutionStatus
Veraltet.

Ruft den aktuellen ActivityExecutionStatus dieser Instanz ab.

(Geerbt von Activity)
Fault
Veraltet.

Ruft das Ausnahmeobjekt ab bzw. legt dieses fest, das von der ThrowActivity ausgelöst wird.

FaultType
Veraltet.

Übernimmt oder bestimmt den Typ der Ausnahme, die von der ThrowActivity ausgelöst wird.

IsDynamicActivity
Veraltet.

Ruft Informationen dazu ab, ob die Aktivität innerhalb des standardmäßigen ActivityExecutionContext der Workflowinstanz ausgeführt wird.

(Geerbt von Activity)
Name
Veraltet.

Ruft den Namen dieser Instanz ab oder legt diesen fest. Dieser Name muss die Namenskonventionen für Variablen der Programmiersprache einhalten, die im Workflowprojekt verwendet wird.

(Geerbt von Activity)
Parent
Veraltet.

Ruft die CompositeActivity ab, die Activity enthält.

(Geerbt von Activity)
ParentDependencyObject
Veraltet.

Ruft das übergeordnete DependencyObject im DependencyObject-Diagramm ab.

(Geerbt von DependencyObject)
QualifiedName
Veraltet.

Ruft den qualifizierten Namen der Aktivität ab. Qualifizierte Aktivitätsnamen sind in einer Workflowinstanz immer eindeutig.

(Geerbt von Activity)
Site
Veraltet.

Ruft einen Verweis auf die Site-Komponente von DependencyObject ab oder legt diesen fest.

(Geerbt von DependencyObject)
UserData
Veraltet.

Ruft ein IDictionary ab, das dieser Klasseninstanz benutzerdefinierte Daten zuordnet.

(Geerbt von DependencyObject)
WorkflowInstanceId
Veraltet.

Ruft die Guid ab, die der Instanz zugeordnet ist.

(Geerbt von Activity)

Methoden

AddHandler(DependencyProperty, Object)
Veraltet.

Fügt einen Handler für ein Ereignis von DependencyObject hinzu.

(Geerbt von DependencyObject)
Cancel(ActivityExecutionContext)
Veraltet.

Wird von der Workflowlaufzeit aufgerufen, um die momentane Ausführung einer Aktivität abzubrechen.

(Geerbt von Activity)
Clone()
Veraltet.

Erstellt eine tiefe Kopie von Activity.

(Geerbt von Activity)
Dispose()
Veraltet.

Gibt alle von DependencyObject verwendeten Ressourcen frei.

(Geerbt von DependencyObject)
Dispose(Boolean)
Veraltet.

Gibt die von DependencyObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von DependencyObject)
Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Execute(ActivityExecutionContext)
Veraltet.

Wird von der Workflowlaufzeit zum Ausführen einer Aktivität aufgerufen.

(Geerbt von Activity)
GetActivityByName(String)
Veraltet.

Gibt die Instanz der Activity zurück, deren Name vom Satz aller Aktivitäten angefordert wird, die unter der Stammaktivität dieser Instanz ausgeführt werden; d. h. innerhalb des Workflows.

(Geerbt von Activity)
GetActivityByName(String, Boolean)
Veraltet.

Gibt die Instanz der Activity zurück, deren Name vom Satz aller Aktivitäten unter der Stamm-Activity dieser Instanz angefordert wird, falls der zweite Parameter false ist, und deren Name unter der aktuellen Activity angefordert wird, falls der zweite Parameter true ist.

(Geerbt von Activity)
GetBinding(DependencyProperty)
Veraltet.

Ermöglicht Zugriff auf die ActivityBind, die der bestimmten DependencyProperty zugeordnet ist.

(Geerbt von DependencyObject)
GetBoundValue(ActivityBind, Type)
Veraltet.

Ruft das Object ab, das der Gegenstand von ActivityBind ist.

(Geerbt von DependencyObject)
GetHashCode()
Veraltet.

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetInvocationList<T>(DependencyProperty)
Veraltet.

Ruft ein Array ab, das die Delegaten für die angegebene DependencyProperty enthält.

(Geerbt von DependencyObject)
GetType()
Veraltet.

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)
Veraltet.

Stellt Zugriff auf den Wert der festgelegten DependencyProperty bereit.

(Geerbt von DependencyObject)
GetValueBase(DependencyProperty)
Veraltet.

Ermöglicht Zugriff auf das gebundene Objekt einer DependencyProperty und umgeht die GetValue(DependencyProperty)-Überschreibung.

(Geerbt von DependencyObject)
HandleFault(ActivityExecutionContext, Exception)
Veraltet.

Wird aufgerufen, wenn eine Ausnahme innerhalb des Kontexts der Ausführung dieser Instanz ausgelöst wird.

(Geerbt von Activity)
Initialize(IServiceProvider)
Veraltet.

Wird von der Workflowlaufzeit aufgerufen, um eine Aktivität während der Erstellung einer neuen Workflowinstanz zu initialisieren. Diese Methode wird während der Erstellung eines dynamischen ActivityExecutionContext aufgerufen.

(Geerbt von Activity)
InitializeProperties()
Veraltet.

Führt Initialisierung von Abhängigkeitseigenschaften aus, wenn eine Überschreibung in einer abgeleiteten Klasse stattfindet.

(Geerbt von DependencyObject)
Invoke<T>(EventHandler<T>, T)
Veraltet.

Abonniert EventHandler und ruft diesen Delegaten auf.

(Geerbt von Activity)
Invoke<T>(IActivityEventListener<T>, T)
Veraltet.

Abonniert IActivityEventListener<T> und ruft diesen Delegaten auf.

(Geerbt von Activity)
IsBindingSet(DependencyProperty)
Veraltet.

Gibt an, ob der Wert einer DependencyProperty als Bindung festgelegt ist. Siehe SetBinding(DependencyProperty, ActivityBind).

(Geerbt von DependencyObject)
MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MetaEquals(DependencyObject)
Veraltet.

Bestimmt, ob metaproperties dieses DependencyObject den metaproperties des parametrisierten DependencyObject entspricht.

(Geerbt von DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)
Veraltet.

Wird bei jedem Laden von ActivityExecutionContext von der Workflowlaufzeit aufgerufen. Beispielsweise wird diese Methode während der Erstellung von ActivityExecutionContext sowie bei jeder erneuten Erstellung von ActivityExecutionContext aufgerufen. Die erneute Erstellung findet statt, wenn eine Workflowinstanz aus dem permanenten Speicher geladen wird.

(Geerbt von Activity)
OnActivityExecutionContextUnload(IServiceProvider)
Veraltet.

Wird bei jedem Entladen von ActivityExecutionContext von der Workflowlaufzeit aufgerufen. Beispielsweise wird diese Methode beim Beenden von ActivityExecutionContext sowie bei jedem Entladen von ActivityExecutionContext aufgerufen, wenn eine Workflowinstanz beibehalten wird.

(Geerbt von Activity)
OnClosed(IServiceProvider)
Veraltet.

Wird von der Workflowlaufzeit als Teil des Übergangs der Aktivität in den Zustand Geschlossen aufgerufen.

(Geerbt von Activity)
RaiseEvent(DependencyProperty, Object, EventArgs)
Veraltet.

Löst eine der angegebenen Abhängigkeitseigenschaft zugeordnete Event aus.

(Geerbt von Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)
Veraltet.

Löst das Ereignis aus, das der DependencyProperty zugeordnet ist, auf die verwiesen wird.

(Geerbt von Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)
Veraltet.

Registriert die angegebene DependencyProperty für das Statusänderungsereignis.

(Geerbt von Activity)
RemoveHandler(DependencyProperty, Object)
Veraltet.

Entfernt einen EventHandler aus einer zugeordneten DependencyProperty.

(Geerbt von DependencyObject)
RemoveProperty(DependencyProperty)
Veraltet.

Entfernt DependencyProperty aus DependencyObject.

(Geerbt von DependencyObject)
Save(Stream)
Veraltet.

Schreibt Activity dauerhaft in Stream.

(Geerbt von Activity)
Save(Stream, IFormatter)
Veraltet.

Schreibt Activity mithilfe des benutzerdefinierten Stream für Serialisierung dauerhaft in IFormatter.

(Geerbt von Activity)
SetBinding(DependencyProperty, ActivityBind)
Veraltet.

Legt die ActivityBind für die angegebene DependencyProperty fest.

(Geerbt von DependencyObject)
SetBoundValue(ActivityBind, Object)
Veraltet.

Legt den Wert der Ziel-ActivityBind fest.

(Geerbt von DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)
Veraltet.

Legt den Wert einer DependencyProperty fest, die schreibgeschützt ist.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)
Veraltet.

Legt den Wert von DependencyProperty für das Objekt fest.

(Geerbt von DependencyObject)
SetValueBase(DependencyProperty, Object)
Veraltet.

Legt den Wert von DependencyProperty auf das angegebene Object fest, wobei SetValue(DependencyProperty, Object) umgangen wird.

(Geerbt von DependencyObject)
ToString()
Veraltet.

Stellt eine Zeichenfolge bereit, die diese Instanz darstellt.

(Geerbt von Activity)
TrackData(Object)
Veraltet.

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.

(Geerbt von Activity)
TrackData(String, Object)
Veraltet.

Informiert die Laufzeitverfolgungsinfrastruktur über ausstehende Verfolgungsinformationen.

(Geerbt von Activity)
Uninitialize(IServiceProvider)
Veraltet.

Ermöglicht beim Überschreiben in einer abgeleiteten Klasse das Aufheben der Initialisierung durch einen Dienstanbieter für die Aktivität.

(Geerbt von Activity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)
Veraltet.

Hebt die Registrierung der angegebenen DependencyProperty für das Statusänderungsereignis auf.

(Geerbt von Activity)

Ereignisse

Canceling
Veraltet.

Tritt auf, wenn die Aktivitätsausführung abgebrochen wird.

(Geerbt von Activity)
Closed
Veraltet.

Tritt ein, wenn die Ausführung von Activity abgeschlossen wurde.

(Geerbt von Activity)
Compensating
Veraltet.

Tritt beim Ausführen einer Kompensierungsmethode in Activity auf.

(Geerbt von Activity)
Executing
Veraltet.

Tritt bei Ausführung von Activity ein.

(Geerbt von Activity)
Faulting
Veraltet.

Tritt auf, wenn eine Ausnahme während des Ausführens der Instanz ausgelöst wird.

(Geerbt von Activity)
StatusChanged
Veraltet.

Tritt auf, wenn sich der ActivityExecutionStatus einer ausgeführten Activity ändert.

(Geerbt von Activity)

Explizite Schnittstellenimplementierungen

IComponent.Disposed
Veraltet.

Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt.

(Geerbt von DependencyObject)
IDynamicPropertyTypeProvider.GetAccessType(IServiceProvider, String)
Veraltet.

Gibt den Zugriffstyp für die angegebene Eigenschaft zurück.

IDynamicPropertyTypeProvider.GetPropertyType(IServiceProvider, String)
Veraltet.

Gibt den Type der angegebenen Eigenschaft zurück.

ITypeFilterProvider.CanFilterType(Type, Boolean)
Veraltet.

Gibt einen Wert zurück, der angibt, ob der angegebene Type gefiltert werden kann.

ITypeFilterProvider.FilterDescription
Veraltet.

Ruft die Beschreibung für den Filter ab, der im Dialogfeld für den Klassenbrowser angezeigt werden soll.

Gilt für: