Freigeben über


TryCatch-Aktivitätsdesigner

Der TryCatch-Aktivitätsdesigner wird verwendet, um eine TryCatch-Aktivität zu erstellen und zu konfigurieren.

Die TryCatch-Aktivität

Die TryCatch-Aktivität enthält eine Try-Aktivität, eine Catch<TException>-Auflistung und eine Try-Aktivität. Ein Catch-Element vom Typ TException enthält ein ExceptionType-Element und ein Action-Element. Zusammen werden diese verwendet, um einen typischen ausnahmebasierten Fehlerbehandlungsmechanismus zu implementieren. Eine TryCatch-Aktivität versucht, die zugehörige Try-Aktivität auszuführen. Wenn die Try-Aktivität eine Ausnahme auslöst, ordnet die TryCatch-Aktivität die Ausnahme anhand der Catch<TException>-Auflistung zu. Wenn eine Übereinstimmung vorhanden ist, wird das Action-Element des entsprechenden Catch<TException>-Elements ausgeführt und dient als Fehlerbehandlungslogik für die Ausnahme. Schließlich führt die TryCatch-Aktivität die zugehörige Finally-Aktivität aus, unabhängig davon, ob eine Ausnahme ausgelöst wurde.

Verwenden des TryCatch-Aktivitätsdesigners

Der TryCatch-Aktivitätsdesigner befindet sich in der Kategorie Fehlerbehandlung der Toolbox, auf die Sie zugreifen, indem Sie im linken Bereich von Workflow-Designer auf die Registerkarte Toolbox klicken. (Alternativ können Sie Symbolleiste im Menü Ansicht wählen oder die Tastenkombination STRG+ALT+X verwenden.)

Sie können den TryCatch-Aktivitätsdesigner aus der Toolbox ziehen und auf der Workflow-Designer-Oberfläche ablegen, wo normalerweise Aktivitäten platziert werden, z. B. in einem Sequence-Element. Hierdurch erstellen Sie eine TryCatch-Aktivität mit dem DisplayName-Standardwert TryCatch. Der DisplayName-Wert kann im Header des TryCatch-Aktivitätsdesigners oder im Feld DisplayName des Eigenschaftenrasters geändert werden. Die anderen Eigenschaften müssen auf der Oberfläche des TryCatch-Aktivitätsdesigners bearbeitet werden.

Klicken Sie in der rechten oberen Ecke im TryCatch-Designer auf die Erweiterungsschaltfläche, um die Felder Try, Catches und Finally in der erweiterten Ansicht anzuzeigen. Um einen Catch hinzuzufügen, klicken Sie im TryCatch-Designer auf die Schaltfläche Neuen Catch hinzufügen. Die Schaltfläche nimmt die Form eines Kombinationsfelds an. Wählen Sie einen Ausnahmetyp aus, und drücken Sie die EINGABETASTE, um den Catch hinzuzufügen. Nachdem Sie einen Catch hinzugefügt haben, wird der Catch-Bereich erweitert, und Sie können eine Aktivität im Catch ablegen, um die Ausführungslogik für den Catch zu definieren. Auf der rechten Seite des erweiterten Catch-Bereichs befindet sich ein Textfeld. In dieses Textfeld können Sie den Namen einer Ausnahmevariablen eingeben. Die Ausnahmevariable kann nur für Aktivitäten im gleichen Catch verwendet werden.

Sie können den Catch im TryCatch-Designer nicht bearbeiten. Wenn Sie den Ausnahmetyp ändern möchten, müssen Sie den Catch löschen und einen neuen Catch hinzufügen. Um einen Catch zu löschen, wählen Sie ihn aus und drücken Sie die ENTF-Taste, oder klicken Sie mit der rechten Maustaste, und wählen Sie im Kontextmenü die Option Löschen.

Die TryCatch-Eigenschaften

Die folgende Tabelle enthält die TryCatch-Eigenschaften und eine Beschreibung zu deren Verwendung im Designer.

Eigenschaftenname Erforderlich Verwendung

DisplayName

False

Gibt den optionalen Anzeigenamen der Throw-Aktivität an. Der Standardwert ist Throw.

Try

Nein

Das Workflowelement, das beim Ausführen von TryCatch zuerst ausgeführt wird.

Catches

Nein

Die Auflistung von Catch-Elementen, die überprüft werden müssen, wenn die Try-Aktivität eine Ausnahme auslöst.

Sie müssen mindestens eine Aktivität in der Catches-Auflistung oder eine Aktivität im Finally-Block hinzufügen.

Finally

Nein

Das Workflowelement, das ausgeführt werden muss, wenn die Ausführung der Try-Aktivität und aller erforderlichen Aktivitäten in der Catches-Auflistung abgeschlossen wurde.

Sie müssen mindestens eine Aktivität in der Catches-Auflistung oder eine Aktivität im Finally-Block hinzufügen.

Siehe auch

Konzepte

Rethrow-Aktivitätsdesigner
Throw-Aktivitätsdesigner

Weitere Ressourcen

Auflistungsaktivitätsdesigner