ThrowActivity Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 IDynamicPropertyTypeProviderPublic 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 |
| 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 |
| 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. |
