Share via

Gewusst wie: Erstellen von Ebenendiagrammen aus Artefakten

  • Artikel

Verwenden Sie in Visual Studio Ultimate Ebenendiagramme, um die allgemeine Architektur des Systems visuell darzustellen und sicherzustellen, dass der Code konsistent mit dem Entwurf bleibt. Organisieren und verknüpfen Sie die Artefakte einer Visual Studio-Projektmappe in logischen, abstrakten Gruppen oder Ebenen. Diese Ebenen beschreiben die Hauptaufgaben, die von diesen Artefakten ausgeführt werden, oder die Hauptkomponenten des Systems.

Abhängigkeiten werden durch Pfeile zwischen den Ebenen dargestellt und geben an, ob Ebenen die Funktionen auf anderen Ebenen verwenden können. Beschreiben Sie die beabsichtigten Abhängigkeiten im Diagramm, um architektonische Einschränkungen für den Code zu erzwingen, und überprüfen Sie anschließend den Code anhand des Diagramms. Durch diese Verwendung von Ebenendiagrammen lässt sich eine bessere Verständlichkeit, Wiederverwendbarkeit, Aktualisierbarkeit und Verwaltbarkeit des Codes erreichen.

Elemente in Ebenendiagrammen

Weitere Informationen zu Ebenendiagrammen finden Sie in den folgenden Themen:

In diesem Thema

  • Erstellen eines Ebenendiagramms

  • Erstellen von Ebenen auf Basis vorhandener Artefakte

  • Verwalten von Links zwischen Ebenen und Artefakten

  • Rückentwickeln vorhandener Abhängigkeiten

  • Aktualisieren des Ebenendiagramms zum Anzeigen des beabsichtigten Entwurfs

  • Ändern der Darstellung von Elementen im Diagramm

Erstellen eines Ebenendiagramms

Ein Ebenendiagramm muss in einem Modellierungsprojekt erstellt werden. Sie können einem vorhandenen Modellierungsprojekt ein neues Ebenendiagramm hinzufügen, oder Sie können in der Projektmappe für das neue Ebenendiagramm eine neue Modellierung erstellen.

So fügen Sie einem Modellierungsprojekt ein neues Ebenendiagramm hinzu

  1. Klicken Sie im Menü Architektur auf Neues Diagramm.

  2. Klicken Sie unter Vorlagen auf Ebenendiagramm.

  3. Benennen Sie das Diagramm.

  4. Navigieren Sie unter Zu Modellierungsprojekt hinzufügen zu einem in der Lösung vorhandenen Modellierungsprojekt, und wählen Sie es aus.

    - oder -

    Klicken Sie auf Neues Modellierungsprojekt erstellen, um der Lösung ein neues Modellierungsprojekt hinzuzufügen.

    Tipp

    Das Ebenendiagramm muss in einem Modellierungsprojekt vorhanden sein. Sie können es allerdings mit Artefakten verknüpfen, die sich an einer beliebigen Stelle in der Lösung befinden.

Sie können auch ein vorhandenes Ebenendiagramm innerhalb des gleichen Modellierungsprojekts kopieren.

Tipp

Fügen Sie Modellierungsprojekten oder anderen Speicherorten in der Projektmappe keine vorhandenen Ebenendiagramme aus Modellierungsprojekten hinzu, und kopieren bzw. verschieben Sie diese nicht. Ein Ebenendiagramm, das auf diese Weise kopiert wird, weist die gleichen Verweise wie das ursprüngliche Diagramm auf, auch wenn Sie das Diagramm ändern. Dies verhindert die ordnungsgemäße Funktion der Ebenenvalidierung und verursacht möglicherweise andere Probleme, z. B. fehlende Elemente oder andere Fehler beim Versuch, das Diagramm zu öffnen.

Führen Sie zum Kopieren eines Ebenendiagramms folgende Schritte aus:

So kopieren Sie ein vorhandenes Ebenendiagramm

  1. Fügen Sie dem Modellierungsprojekt ein neues Ebenendiagramm hinzu.

  2. Kopieren Sie die Elemente aus dem Quellebenendiagramm in das neue Ebenendiagramm.

Erstellen von Ebenen auf Basis von Artefakten

Ebenen können aus Artefakten in einer Visual Studio-Lösung erstellt werden, z. B. Projekte, Codedateien, Namespaces, Klassen oder Methoden. Dabei werden automatisch Verknüpfungen zwischen den Ebenen und den Artefakten erstellt, die im Ebenenvalidierungsprozess enthalten sind. Außerdem können Sie Ebenen mit bestimmten Arten von Artefakten verknüpfen, die keine Ebenenvalidierung unterstützen. Beispielsweise können Sie Ebenen mit Dateien wie Word-Dokumenten oder PowerPoint-Präsentationen verknüpfen. Dies ist hilfreich, um einer Ebene Spezifikationen oder Pläne zuzuordnen. Öffnen Sie den Ebenen-Explorer und überprüfen Sie die Eigenschaft Unterstützt die Validierung des Artefakts, um festzustellen, ob ein verknüpftes Artefakt die Validierung unterstützt. Weitere Informationen finden Sie unter Verwalten von Links zu Artefakten.

Jede Ebene wird im Diagramm als Rechteck angezeigt und kann geschachtelte Ebenen enthalten, die ausführlichere Aufgaben beschreiben. Weitere Informationen zu Ebenenmuster finden Sie auf der Patterns & Practices-Website.

Die Zahl auf einer Ebene gibt die Anzahl von Artefakten an, die mit der Ebene verknüpft sind. Beachten Sie jedoch Folgendes, wenn Sie diese Zahl lesen:

  • Wenn eine Ebene mit einem Artefakt verknüpft ist, das andere Artefakte enthält, die Ebene jedoch nicht direkt mit den anderen Artefakten verknüpft ist, umfasst die Zahl nur das verknüpfte Artefakt. Die anderen Artefakte werden jedoch während der Ebenenvalidierung für die Analyse berücksichtigt.

    Ist z. B. eine Ebene mit einem einzelnen Namespace verknüpft, ist die Anzahl der verknüpften Artefakte 1, auch wenn der Namespace Klassen enthält. Wenn die Ebene auch mit den einzelnen Klassen im Namespace verknüpft ist, umfasst die Zahl die verknüpften Klassen.

  • Wenn eine Ebene andere Ebenen enthält, die mit Artefakten verknüpft sind, ist die Containerebene ebenfalls mit diesen Artefakten verknüpft, obwohl in der Zahl auf der Containerebene diese Artefakte nicht berücksichtigt sind.

Möglicherweise erstellen Sie beim Erstellen eines Ebenendiagramms Abhängigkeitsdiagramme, die Ihnen beim Untersuchen und Verstehen des Codes helfen. Diese Diagramme unterstützen Sie beim Erkennen von Clustern, Mustern, natürlichen Ebenen und Abhängigkeiten im Code. Dies erleichtert die Zuweisung von Artefakten zu Ebenen. Mithilfe des Architektur-Explorers können auch Namespaces und Klassen untersucht werden, die häufig den vorhandenen Ebenen entsprechen. Anschließend können Sie den Code mithilfe von Ebenendiagrammen aktualisieren.

Weitere Informationen finden Sie unter den folgenden Themen:

Verwenden Sie zum Erstellen von Ebenen die folgenden Aufgaben:

Zweck

Schritte

Erstellen einer Ebene für ein einzelnes Artefakt

  1. Ziehen Sie das Artefakt aus einer der folgenden Quellen in das Ebenendiagramm:

  2. Ändern Sie den Namen der Ebene, um die Aufgaben des zugeordneten Codes oder der Artefakte widerzuspiegeln.

Erstellen einer einzelnen Ebene für alle ausgewählten Artefakte

Ziehen Sie alle Artefakte gleichzeitig in das Ebenendiagramm.

Im Diagramm wird eine Ebene angezeigt und mit allen Artefakten verknüpft.

Erstellen einer Ebene für jedes ausgewählte Artefakt

Halten Sie die UMSCHALTTASTE gedrückt, während Sie alle Artefakte gleichzeitig in das Ebenendiagramm ziehen.

HinweisHinweis
Wenn Sie mithilfe der UMSCHALTTASTE einen Bereich von Elementen auswählen, lassen Sie die Taste nach dem Auswählen der Artefakte los.Halten Sie sie anschließend erneut gedrückt, wenn Sie die Artefakte in das Diagramm ziehen.

Im Diagramm wird für jedes Artefakt eine Ebene angezeigt und mit den einzelnen Artefakten verknüpft.

Hinzufügen eines Artefakts zu einer Ebene

Ziehen Sie das Artefakt auf die Ebene.

Erstellen einer neuen, nicht verknüpften Ebene

Erweitern Sie in der Toolbox den Abschnitt Ebenendiagramm, und ziehen Sie anschließend eine Ebene in das Ebenendiagramm.

Doppelklicken Sie zum Erstellen mehrerer Ebenen auf das Tool. Klicken Sie nach Abschluss des Vorgangs auf das Tool Zeiger, oder drücken Sie ESC.

- oder -

Klicken Sie mit der rechten Maustaste auf das Ebenendiagramm, zeigen Sie auf Hinzufügen, und klicken Sie anschließend auf Ebene.

Erstellen geschachtelter Ebenen

Ziehen Sie eine vorhandene Ebene auf eine andere Ebene.

- oder -

Klicken Sie mit der rechten Maustaste auf eine Ebene, zeigen Sie auf Hinzufügen, und klicken Sie anschließend auf Ebene.

Erstellen einer neuen Ebene, die mehrere vorhandene Ebenen enthält

Wählen Sie die Ebenen aus, klicken Sie mit der rechten Maustaste auf eine ausgewählte Ebene, und klicken Sie anschließend auf Gruppe.

Ändern der Farbe einer Ebene

Legen Sie die Eigenschaft Farbe auf die gewünschte Farbe fest.

Angeben, dass einer Ebene zugeordnete Artefakte nicht zu den angegebenen Namespaces gehören dürfen

Geben Sie die Namespaces in die Eigenschaft für unzulässige Namespaces der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

Angeben, dass einer Ebene zugeordnete Artefakte nicht von den angegebenen Namespaces abhängen dürfen

Geben Sie die Namespaces in die Eigenschaft für unzulässige Namespaceabhängigkeiten der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

Angeben, dass einer Ebene zugeordnete Artefakte zu einem der angegebenen Namespaces gehören müssen

Geben Sie den Namespace in die Eigenschaft für erforderliche Namespaces der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

  1. Klicken Sie im Ebenendiagramm mit der rechten Maustaste auf eine Ebene, und klicken Sie anschließend auf Links anzeigen.

    Im Ebenen-Explorer werden die Artefaktlinks für die ausgewählte Ebene angezeigt.

  2. Verwenden Sie zum Verwalten dieser Links die folgenden Aufgaben:

Zweck

Im Ebenen-Explorer

Löschen des Links zwischen der Ebene und einem Artefakt

Klicken Sie mit der rechten Maustaste auf den Artefaktlink, und klicken Sie anschließend auf Löschen.

Verschieben des Links von einer Ebene auf eine andere Ebene

Ziehen Sie den Artefaktlink auf eine Ebene im Diagramm.

- oder -

  1. Klicken Sie mit der rechten Maustaste auf den Artefaktlink, und klicken Sie anschließend auf Ausschneiden.

  2. Klicken Sie im Ebenendiagramm mit der rechten Maustaste auf die Ebene, und klicken Sie anschließend auf Einfügen.

Kopieren des Links von einer Ebene auf eine andere Ebene

  1. Klicken Sie mit der rechten Maustaste auf den Artefaktlink, und klicken Sie anschließend auf Kopieren.

  2. Klicken Sie im Ebenendiagramm mit der rechten Maustaste auf die Ebene, und klicken Sie anschließend auf Einfügen.

Erstellen einer neuen Ebene aus einem vorhandenen Artefaktlink

Ziehen Sie den Artefaktlink in einen leeren Bereich des Diagramms.

Überprüfen, ob ein verknüpftes Artefakt die Validierung anhand des Ebenendiagramms unterstützt

Suchen Sie in der Spalte Unterstützt die Validierung nach dem Artefaktlink.

Rückentwickeln vorhandener Abhängigkeiten

Eine Abhängigkeit ist überall dort vorhanden, wo ein Artefakt, das einer Ebene zugeordnet ist, einen Verweis auf ein Artefakt enthält, das einer anderen Ebene zugeordnet ist. Beispiel: Eine Klasse in einer Ebene deklariert eine Variable, deren Klasse sich auf einer anderen Ebene befindet. Bei vorhandenen Abhängigkeiten von Artefakten, die mit Ebenen des Diagramms verknüpft sind, ist eine Rückentwicklung möglich.

Tipp

Bei bestimmten Arten von Artefakten ist keine Rückentwicklung der Abhängigkeiten möglich. So kann beispielsweise bei einer Ebene, die mit einer Textdatei verknüpft ist, keinerlei Rückentwicklung der Abhängigkeiten vorgenommen werden. Klicken Sie zum Anzeigen der Artefakte mit Abhängigkeiten, bei denen eine Rückentwicklung möglich ist, mit der rechten Maustaste auf mindestens eine Ebene, und klicken Sie anschließend auf Links anzeigen. Überprüfen Sie im Ebenen-Explorer die Spalte Unterstützt die Validierung. Bei Artefakten, die in dieser Spalte den Eintrag False enthalten, ist keine Rückentwicklung von Abhängigkeiten möglich.

So führen Sie eine Rückentwicklung vorhandener Abhängigkeiten zwischen Ebenen aus

  • Wählen Sie mindestens eine Ebene aus, klicken Sie mit der rechten Maustaste auf die ausgewählte Ebene, und klicken Sie anschließend auf Abhängigkeiten generieren.

In der Regel sind einige unerwünschte Abhängigkeiten vorhanden. Diese Abhängigkeiten können bearbeitet werden, um sie mit dem geplanten Entwurf in Einklang zu bringen.

Aktualisieren des Diagramms zum Anzeigen des beabsichtigten Entwurfs

Aktualisieren Sie das Ebenendiagramm, um die geplanten Änderungen oder die gewünschte Architektur anzuzeigen.

Zweck

Auszuführende Schritte

Löschen einer unerwünschten Abhängigkeit

Klicken Sie auf die Abhängigkeit, und drücken Sie ENTF.

Ändern oder Einschränken der Richtung einer Abhängigkeit

Legen Sie die Eigenschaft Richtung fest.

Erstellen von neuen Abhängigkeiten

Verwenden Sie die Tools Abhängigkeit und Bidirektionale Abhängigkeit.

Doppelklicken Sie zum Zeichnen mehrerer Abhängigkeiten auf das Tool. Klicken Sie nach Abschluss des Vorgangs auf das Tool Zeiger, oder drücken Sie ESC.

Angeben, dass einer Ebene zugeordnete Artefakte nicht von den angegebenen Namespaces abhängen dürfen

Geben Sie die Namespaces in die Eigenschaft für unzulässige Namespaceabhängigkeiten der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

Angeben, dass einer Ebene zugeordnete Artefakte nicht zu den angegebenen Namespaces gehören dürfen

Geben Sie die Namespaces in die Eigenschaft für unzulässige Namespaces der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

Angeben, dass einer Ebene zugeordnete Artefakte zu einem der angegebenen Namespaces gehören müssen

Geben Sie den Namespace in die Eigenschaft für erforderliche Namespaces der Ebene ein. Trennen Sie die Namespaces mit einem Semikolon (;).

Ändern der Darstellung von Elementen im Diagramm

Bearbeiten Sie Darstellung und Layout des Diagramms, um die Suche nach Ebenen und Abhängigkeiten sowie Diskussionen mit Teammitgliedern zu vereinfachen. Führen Sie hierzu die folgenden Schritte aus:

  • Ändern der Größe, Form und Position von Ebenen

  • Ändern der Farbe von Ebenen und Abhängigkeiten

    1. Wählen Sie die Ebenen oder Abhängigkeiten aus.

    2. Klicken Sie mit der rechten Maustaste auf die ausgewählten Ebenen oder Abhängigkeiten, und klicken Sie anschließend auf Eigenschaften.

    3. Ändern Sie im Eigenschaftenfenster die Eigenschaft Farbe.

Siehe auch

Konzepte

Visualisieren von vorhandenem Code