Gewusst wie: Erstellen von Ebenendiagrammen aus Artefakten

Artikel
08/10/2011

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

Klicken Sie im Menü Architektur auf Neues Diagramm.
Klicken Sie unter Vorlagen auf Ebenendiagramm.
Benennen Sie das Diagramm.
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

Fügen Sie dem Modellierungsprojekt ein neues Ebenendiagramm hinzu.
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	Ziehen Sie das Artefakt aus einer der folgenden Quellen in das Ebenendiagramm: Projektmappen-Explorer Beispiele: Dateien oder Projekte. Architektur-Explorer Beispiele: Namespaces, Klassen oder Methoden. Weitere Informationen finden Sie unter Gewusst wie: Suchen von Code im Architektur-Explorer. Abhängigkeitsdiagramme Weitere Informationen finden Sie unter Gewusst wie: Generieren von Abhängigkeitsdiagrammen für .NET-Code. Im Diagramm wird eine Ebene angezeigt und mit dem Artefakt verknüpft. Ä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. Hinweis 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 (;).

Verwalten von Links zwischen Ebenen und Artefakten

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.
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 - Klicken Sie mit der rechten Maustaste auf den Artefaktlink, und klicken Sie anschließend auf Ausschneiden. 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	Klicken Sie mit der rechten Maustaste auf den Artefaktlink, und klicken Sie anschließend auf Kopieren. 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

Freigeben über