Gewusst wie: Erstellen einer benutzerdefinierten Aktivitätsvorlage
Dieses Thema gilt für Windows Workflow Foundation 4.
Benutzerdefinierte Aktivitätsvorlagen werden verwendet, um die Konfiguration von Aktivitäten, einschließlich benutzerdefinierter zusammengesetzter Aktivitäten, anzupassen. Dadurch müssen Benutzer die Aktivitäten nicht einzeln erstellen und alle zugehörigen Eigenschaften und anderen Einstellungen manuell konfigurieren. Diese benutzerdefinierten Vorlagen können in der Toolbox im Windows Workflow Designer oder in einem neu gehosteten Designer zur Verfügung gestellt werden, aus dem die Benutzer sie auf die vorkonfigurierte Entwurfsoberfläche ziehen können. Zu Workflow-Designer gehören gute Beispiele für solche Vorlagen: SendAndReceiveReply Template Designer und ReceiveAndSendReply Template Designer in der Kategorie Messaging Activity Designers.
Das erste Verfahren in diesem Thema beschreibt, wie eine benutzerdefinierte Aktivitätsvorlage für eine Delay-Aktivität erstellt wird, und das zweite Verfahren beschreibt kurz, wie sie in Workflow-Designer verfügbar gemacht wird, um die Funktionsfähigkeit der benutzerdefinierten Vorlage zu überprüfen.
Benutzerdefinierte Aktivitätsvorlagen müssen IActivityTemplateFactory implementieren. Die Schnittstelle verfügt über eine einzelne Create-Methode, mit der Sie die in der Vorlage verwendeten Aktivitätsinstanzen erstellen und konfigurieren können.
So erstellen Sie eine Vorlage für die Delay-Aktivität
Starten Sie Visual Studio 2010.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Das Dialogfeld Neues Projekt wird angezeigt.
Wählen Sie im Bereich Projekttypen die Option Workflow für Visual C#-Projekte oder Visual Basic-Gruppierungen aus, abhängig von der bevorzugten Sprache.
Wählen Sie im Bereich Vorlagen die Option Aktivitätsbibliothek aus.
Geben Sie im Feld Name den Wert DelayActivityTemplate ein.
Übernehmen Sie die Standardwerte in den Textfeldern Speicherort und Projektmappenname, und klicken Sie dann auf OK.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Verzeichnis "Verweise" des DelayActivityTemplate-Projekts, und wählen Sie Verweis hinzufügen aus, um das Dialogfeld Verweis hinzufügen zu öffnen.
Wechseln Sie zur Registerkarte .NET, und wählen Sie PresentationFramework in der Spalte Komponentenname auf der linken Seite aus, und klicken Sie auf OK, um einen Verweis auf die Datei "PresentationFramework.dll" hinzuzufügen.
Wiederholen Sie dieses Verfahren, um Verweise auf die Dateien "System.Activities.Presentation.dll" und "WindowsBase.dll" hinzuzufügen.
Klicken Sie mit der rechten Maustaste auf das Projekt "DelayActivityTemplate" im Projektmappen-Explorer, und wählen Sie Hinzufügen und dann Neues Element aus, um das Dialogfeld Neues Element hinzufügen zu öffnen.
Wählen Sie die Vorlage Klasse aus, nennen Sie sie "MyDelayTemplate", und klicken Sie dann auf OK.
Öffnen Sie die Datei "MyDelayTemplate.cs", und fügen Sie die folgenden Anweisungen hinzu.
//Namespaces added using System.Activities; using System.Activities.Statements; using System.Activities.Presentation; using System.Windows;Implementieren Sie IActivityTemplateFactory mit der
MyDelayActivity-Klasse mit dem folgenden Code. Damit wird die Verzögerung mit einer Dauer von 10 Sekunden konfiguriert.public sealed class MyDelayActivity : IActivityTemplateFactory { public Activity Create(System.Windows.DependencyObject target) { return new System.Activities.Statements.Delay { DisplayName = "DelayActivityTemplate", Duration = new TimeSpan(0, 0, 10) }; } }Wählen Sie Projektmappe erstellen im Menü Erstellen aus, um die Datei "DelayActivityTemplate.dll" zu generieren.
So machen Sie die Vorlage in einem Workflow-Designer verfügbar
Klicken Sie mit der rechten Maustaste auf die Projektmappe "DelayActivityTemplate" im Projektmappen-Explorer, und wählen Sie Hinzufügen und dann Neues Projekt aus, um das Dialogfeld Neues Projekt hinzufügen zu öffnen.
Wählen Sie die Vorlage Konsolenanwendung für Workflows aus, nennen Sie sie CustomActivityTemplateApp, und klicken Sie dann auf OK.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Verzeichnis "Verweise" des CustomActivityTemplateApp-Projekts, und wählen Sie Verweis hinzufügen aus, um das Dialogfeld Verweis hinzufügen zu öffnen.
Wechseln Sie zur Registerkarte Projekte, wählen Sie DelayActivityTemplate in der Spalte Projektname auf der linken Seite aus, und klicken Sie auf OK, um einen Verweis auf die Datei "DelayActivityTemplate.dll" hinzuzufügen, die Sie im ersten Verfahren erstellt haben.
Klicken Sie mit der rechten Maustaste auf das Projekt "CustomActivityTemplateApp" im Projektmappen-Explorer, und wählen Sie Erstellen aus, um die Anwendung zu kompilieren.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt "CustomActivityTemplateApp", und wählen Sie Als Startprojekt festlegen aus.
Wählen Sie Starten ohne Debugging im Menü Debuggen aus, und drücken Sie eine beliebige Taste, um fortzufahren, wenn Sie im Fenster "cmd.exe" dazu aufgefordert werden.
Öffnen Sie die Datei "Workflow1.xaml", und öffnen Sie die Toolbox.
Suchen Sie die Vorlage MyDelayActivity in der Kategorie DelayActivityTemplate. Ziehen Sie sie auf die Entwurfsoberfläche. Bestätigen Sie im Fenster Eigenschaften, dass die Duration-Eigenschaft auf 10 Sekunden festgelegt wurde.
Beispiel
Die Datei "MyDelayActivity.cs" sollte den folgenden Code enthalten.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
//Namespaces added
using System.Activities;
using System.Activities.Statements;
using System.Activities.Presentation;
using System.Windows;
namespace DelayActivityTemplate
{
public sealed class MyDelayActivity : IActivityTemplateFactory
{
public Activity Create(System.Windows.DependencyObject target)
{
return new System.Activities.Statements.Delay
{
DisplayName = "DelayActivityTemplate",
Duration = new TimeSpan(0, 0, 10)
};
}
}
}