Aktivität ClearCollection
Die Aktivität ClearCollection ist aus dem Standard der Windows Workflow Foundation von Microsoft. Sie wird verwendet um eine Collection, die bereits Elemente enthält, zu leeren. Sie entspricht in ihrem Verhalten der Methode Collection<T>.Clear Method des .NET Frameworks. Die Entwickler Dokumentation von Microsoft zur ClearCollection Aktivität befindet sich hier.
Funktionsweise
Die ClearCollection Aktivität kann mittels Drag&Drop von der Toolbox auf einen Workflow gezogen und mit anderen Aktivitäten zu einer Schrittfolge verbunden werden. Ist die ClearCollection Aktivität Teil eines Workflows, wie auf der Abbildung unten gezeigt, können Ihre Felder über den Eigenschaftsbereich ausgefüllt werden. Im Gegensatz zu vielen anderen Aktivitäten, können die Eigenschaften der ClearCollection Aktivität nicht direkt auf dem Workflow verändert werden.
Um die ClearCollection Aktivität verwenden zu können, muss in dem Testfall eine Collection als Variable definiert sein. In der Abbildung unten, ist eine Variable mit dem Namen "EineListe" definiert. Bei der Variable handelt es sich um eine Liste die Guids enthält. Listen sind eine Form von Collections, die Variable kann also mit der ClearCollection Aktivität verwendet werden. Die Belegung der Variablen mit dem Standardwert new List(of Guid) im Variablenbereich, stellt sicher, dass die Variable bei Start des Testfalls eine gültige aber leere Liste ist.
Wie in der Abbildung unten zu sehen, können für die ClearCollection Aktivität drei Eigenschaften gesetzt werden.
Abb. 1: ClearCollection Aktivität in der Toolbox und im Workflow
Felder
- Collection
- In dieses Feld tragen Sie eine Variable ein, die auf eine Collection zeigt, die Sie zurücksetzen möchten. Die Variable muss initialisiert sein und auf eine gültige Instanz einer Collection (z. B. eine mit
newinstanziierteList<T>) zeigen.
- In dieses Feld tragen Sie eine Variable ein, die auf eine Collection zeigt, die Sie zurücksetzen möchten. Die Variable muss initialisiert sein und auf eine gültige Instanz einer Collection (z. B. eine mit
- DisplayName
- In dem Feld "DisplayName" können Sie in wenigen kurzen Worten die Bedeutung der Aktivität für den Ablauf des Testfalls angeben. Alle Aktivitäten haben die Eigenschaft "DisplayName" und zeigen diese im Workflow als Überschrift der Aktivität an. Beispielsweise "Neue Kundennr. merken" ist ein guter "DisplayName". Er ist knapp, deskriptiv und gut verständlich.
- TypeArgument
- In dieses Feld geben Sie den Typ des Elementes an. Ist beispielsweise Ihr Element eine String Variable, dann wählen Sie auch in diesem Feld "String" aus. Anwendern, die selbst nicht programmieren, wird es etwas komisch vorkommen, dass man erst beim Erstellen seiner Collection einen Typ angeben muss. Dann muss man ggf. beim Erstellen der Variablen, die man in die Collection geben möchte wieder den Typ angeben. Und nun bei der AddToCollection Aktivität muss man erneut denselben Typ angeben. Ignorieren Sie das einfach und seien Sie erleichtert, dass es immer der gleiche Typ ist, den Sie angeben müssen.
