Bearbeiten und Anpassen von Abhängigkeitsdiagrammen

Sie können Abhängigkeitsdiagramme bearbeiten, ohne den zugrunde liegenden Code zu beeinflussen.Dies ist hilfreich, wenn Sie sich auf Schlüsselelemente konzentrieren oder Ideen zum Code mitteilen möchten.Beispielsweise um interessante Bereiche hervorzuheben, können Sie Knoten auswählen und sie filtern, des Stils von Knoten und Links, Ausblenden oder Löschungsknoten ändern, und Knoten mithilfe der Eigenschaften, der Kategorien oder der Gruppen organisieren.

Sie können ein Diagramm weiter anpassen, indem Sie die Directed Graph Markup Language des Diagramms (.dgml) bearbeiten.Beispielsweise können Sie Elemente bearbeiten, um benutzerdefinierte Stile anzugeben, Eigenschaften und Kategorien zu Knoten und Links zuzuweisen oder Knoten zu den Elementen, wie Dokumenten, URL oder anderen Diagramme zuzuweisen.

Hinweis

Visual Studio bereinigt alle nicht verwendeten DGML-Elemente und Attribute auf, indem sie es gelöscht wird, wenn Sie die DGML-Datei speichern.Es werden auch automatisch Knotenelemente erstellt, wenn Sie neue Links manuell hinzufügen. Wenn Sie die DGML-Datei speichern, werden möglicherweise alle Attribute, die Sie einem Element hinzugefügt haben, in alphabetischer Reihenfolge neu angeordnet.Weitere Informationen zu DGML-Elementen finden Sie unter Grundlegendes zur Directed Graph Markup Language (DGML).

Anforderungen

• Visual Studio Ultimate, Visual Studio Premium oder Visual Studio Professional

  Um Abhängigkeitsdiagramme zu erstellen, müssen Sie Visual Studio Ultimate haben.Siehe Visualisieren von Codeabhängigkeiten in Abhängigkeitsdiagrammen.

In diesem Thema

• Ausgewählte Knoten oder Links

• Benennen Sie Knoten oder Links

• Aus- oder Einblenden von Knoten und Links an

• Fügen Sie Knoten und Links hinzu

• Fügen Sie Kommentare Diagramm hinzu

• Löschen Sie Knoten

• Gruppieren Sie Knoten

• Führen Sie Diagramme zusammen

• Ändern des Diagrammstils

• Ändern Sie den Knoten oder Link Sie Format

• Kopieren von Stilen aus einem Diagramm in ein anderes Diagramm

• Zuweisen von Eigenschaften zu Knoten und Links

• Zuweisen von Kategorien zu Knoten und Links

• Verknüpfen Sie Elemente auf Knoten oder Links die

• Erstellen von Aliasen für häufig verwendete Pfade

Ausgewählte Knoten oder Links

To	Auszuführende Schritte
Auswählen aller nicht ausgewählten Knoten	Öffnen Sie das Kontextmenü für die ausgewählten Knoten.Wählen Sie Auswählen, Auswahl umkehren aus.
Wählen Sie weitere Knoten aus, die mit ausgewählten verknüpfen	Öffnen Sie das Kontextmenü für die ausgewählten Knoten.Wählen Sie Auswählen und eine der folgenden Optionen aus: Um zusätzliche Knoten auszuwählen der direkt zum ausgewählten Knoten verknüpfen, wählen Sie Eingehende Abhängigkeiten. Um zusätzliche Knoten auszuwählen die direkt vom ausgewählten Knoten verknüpfen, wählen Sie Ausgehende Abhängigkeiten. Um zusätzliche Knoten auszuwählen die direkt vom und zum ausgewählten Knoten verknüpfen, wählen Sie Beides. Um alle Knoten zusätzlich auszuwählen die vom und zum ausgewählten Knoten verknüpfen, wählen Sie Verbundenes Unterdiagramm. Um alle untergeordneten Elemente des ausgewählten Knotens zusätzlich auszuwählen, wählen Sie Untergeordnete Elemente.

Benennen Sie Knoten oder Links

• Wählen Sie den Knoten oder den Link aus.Drücken Sie F2.Wenn das Eingabefeld angezeigt wird, benennen Sie den Knoten oder den Link.

  Wenn die Bezeichnung angezeigt wird, wählen Sie die Bezeichnung aus.

Aus- oder Einblenden von Knoten und Links an

Ausblenden von Knoten enthält sie von der Beteiligung an den Layoutalgorithmen.Standardmäßig werden gruppenübergreifende Links ausgeblendet.Gruppenübergreifende Links sind einzelne Links, die Knoten über Gruppen herstellen.Wenn Gruppen reduziert werden, aggregiert das Diagramm alle gruppenübergreifenden Links in einzelne Links zwischen Gruppen.Wenn Sie eine Gruppe und ausgewählten Knoten in der Gruppe erweitern, werden die gruppenübergreifende Links und die Abhängigkeiten in dieser Gruppe an.

Vorsicht
Bevor Sie ein Diagramm freigeben, das in Visual Studio Ultimate mit denen erstellt wurde, die Visual Studio Premium oder Visual Studio Professional verwenden, vergewissern Sie sich, alle Knoten oder gruppenübergreifenden Links einzublenden, die Sie andere finden möchten.Andernfalls sind diese Benutzer nicht in der Lage, diese Elemente einzublenden.

So fügen Sie Knoten anzeigen oder ausblenden

To	Auszuführende Schritte
Ausblenden ausgewählter Knoten	Ausgewählte Knoten, die Sie ausblenden möchten. Öffnen Sie das Kontextmenü für die ausgewählten Knoten oder für das Diagramm.Wählen Sie Auswählen, Ausgewählte ausblenden aus.
Ausblenden nicht ausgewählter Knoten	Ausgewählte Knoten, die Sie sichtbar bleiben möchten. Öffnen Sie das Kontextmenü für die ausgewählten Knoten oder für das Diagramm.Wählen Sie Auswählen, Nicht markierte ausblenden aus.
Zeigen Sie ausgeblendete Knoten an	Um alle ausgeblendeten Knoten innerhalb einer Gruppe anzuzeigen, muss die Gruppe zuerst erweitert wird.Wählen Sie Untergeordnete Elemente einblenden in der oberen linken Ecke der Gruppe aus. Um alle ausgeblendeten Knoten anzuzeigen, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Auswahl, Alle einblenden aus.
Ausblenden von Knoten aus, indem Sie die DGML-Datei bearbeiten	Öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gehe zu, DGML aus. Visual Studio öffnet die DGML-Datei des Diagramms. Fügen Sie im <Node/>-Element das folgende Attribut hinzu, um den Knoten auszublenden: Visibility="Hidden" Beispiel: <Nodes> <Node Id="MyNode" Visibility="Hidden"/> </Nodes>

So blenden Sie Links ein oder aus

To	Wählen Sie auf der Diagrammsymbolleiste öffnen Sie die Liste Ändern, wie Links im Diagramm gerendert werden oder öffnen Sie das Diagrammkontextmenü. Wählen Sie aus:
Zeigen Sie gruppenübergreifende Links jederzeit an	Alle gruppenübergreifenden Links anzeigen Dieses blendet aggregierte Links zwischen Gruppen aus.
Zeigt nur gruppenübergreifende Links für ausgewählte Knoten an	Gruppenübergreifende Links für ausgewählte Knoten anzeigen
Ausblenden von gruppenübergreifenden Links jederzeit aus	Ausblenden von gruppenübergreifenden Links aus
Ausblenden aller Links (oder Anzeigen aller Links)	Alle Links ausblenden Um alle Links anzuzeigen, wählen Sie Alle Links ausblenden erneut um den Modus zu deaktivieren.

Fügen Sie Knoten und Links hinzu

So fügen Sie einen neuen undefinierten Knoten hinzufügen	Auszuführende Schritte
Am aktuellen Zeigerposition	Wählen Sie einen Ort im Diagramm aus, wo der neue Knoten ablegt.Drücken Sie Insert.
Dieses Links zum ausgewählten Knoten	Wählen Sie den Quellknoten aus. Start einer Symbolleiste, über dem Knoten angezeigt. Wählen Sie in der Symbolleiste Neuen Knoten mit derselben Kategorie wie dieser Knoten erstellen und neuen Link hinzufügen aus. Wählen Sie einen Platz auf dem Diagramm, um den neuen Knoten zu setzen. (Tastatur: Drücken Sie Registerkarte auf den Knoten, von dem Sie verknüpfen haben den Fokus, und ALT+Insert drücken möchten.)
Dieses Links zu einem vorhandenen Knoten mit aktuellem Fokus	Drücken Sie Registerkarte auf den Knoten, das Sie verknüpfen möchten haben den Fokus.Drücken Sie ALT+ +UMSCHALTInsert.

So fügen Sie Knoten für hinzufügen	Auszuführende Schritte
Elemente in der Projektmappe	Suchen Sie das Element in Projektmappen-Explorer.Verwenden Sie das Projektmappen-Explorer Suchfeld oder suchen Sie die Projektmappe.Um den Code in Projektmappen-Explorer zu durchsuchen, finden Sie unter Anzeigen der Codestruktur. Tipp Um Elemente zu suchen den Abhängigkeiten in einem Typ oder Member haben, öffnen Sie das Kontextmenü für den Typ oder Member in Projektmappen-Explorer.Wählen Sie die Beziehung aus, die für Sie.Projektmappen-Explorer zeigt nur die Elemente mit den angegebenen Abhängigkeiten an. Ziehen Sie die Elemente, die Sie der Diagrammoberfläche interessieren. Um die Elemente Containerhierarchie für die ausgewählten Elemente eingeschlossen wenn Sie Visual Studio Ultimate verwenden, halten Sie die STRG Schlüssel während Sie Elemente in das Diagramm ziehen. - oder - Klicken Sie auf Projektmappen-Explorer öffnen Sie die Erstellen Sie ein neues Diagrammdokument… Liste.Wählen Sie Zum aktiven Abhängigkeitsdiagramm hinzufügen aus.Um die Elemente Containerhierarchie hinzuzufügen, wählen Sie Zum aktiven Abhängigkeitsdiagramm mit Kapselungshierarchie hinzufügen stattdessen. Visual Studio fügt Knoten der Code der obersten Ebene-Elemente in der Auswahl hinzu.Um anzuzeigen wenn ein Knoten Elemente enthält, bewegen Sie den Mauszeiger auf den Knoten für das Chevron (^) angezeigt.Wählen Sie das Chevron (^) den Knoten zu erweitern.Um alle Knoten zu erweitern, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gruppe, Alle erweitern aus. Hinweis Dieser Befehl ist nicht verfügbar, wenn, alle Gruppen verschoben, Probleme unbrauchbaren eines Diagramms oder des Arbeitsspeichers erzeugt.
Elemente mit den Knoten im Diagramm	Öffnen Sie das Kontextmenü für den Knoten.Wählen Sie Anzeigen und die Art der Beziehung aus, die für Sie. Eine Assembly wählen Sie aus: Assemblys, auf die verwiesen wird,: Fügen Sie Assemblys hinzugefügt, die dieses Assemblyverweise.Externe Assemblys werden in der Gruppe Extern. Verweisen auf Assemblys: Fügen Sie Assemblys in der Projektmappe hinzu, die diese verweisen. Für eine Klasse wählen Sie aus: Basistypen: Eine Klasse fügen Sie die Basisklasse und die implementierten Schnittstellen hinzu. Für eine Schnittstelle fügen Sie die Basisschnittstellen hinzu. Abgeleitete Typen: Eine Klasse fügen Sie die abgeleiteten Klassen hinzu. Für eine Schnittstelle fügen Sie die abgeleiteten Schnittstellen und die implementierenden Klassen oder die Strukturen hinzu. Alle Basistypen: Fügen Sie die Basisklassen- oder Schnittstellenhierarchie rekursiv hinzu. Alle abgeleiteten Typen: Eine Klasse fügen Sie alle abgeleiteten Klassen rekursiv hinzu. Für eine Schnittstelle fügen Sie alle abgeleiteten Schnittstellen und rekursiv implementieren Klassen oder Strukturen hinzu. Kapselungshierarchie: Fügen Sie die Elemente Containerhierarchie hinzu. Verwendete Typen: Fügen Sie alle Klassen und ihre Member hinzu, die diese Klasse verwendet. Verwendete-durch Typen: Fügen Sie alle Klassen und ihre Member hinzu, die diese Klasse verwenden. Eine Methode wählen Sie aus: Kapselungshierarchie: Fügen Sie die Elemente Containerhierarchie hinzu. Aufgerufene Methods: Hinzufügen von Methoden, die dieses. Aufgerufene-durch Methoden: Hinzufügen von Methoden, die diese Methode aufrufen. Überschriebene Methoden in den Basistypen: Eine Methode, die andere Methoden überschreibt oder die Methode einer Schnittstelle implementiert, fügen Sie alle abstrakten oder virtuellen Methoden in den Basisklassen, die überschrieben und (sofern vorhanden) in der - Methode der - Schnittstelle hinzu, die implementiert werden. Relevante Felder: Fügen Sie Felder hinzu, die diese Methode verweist. Ein Feld wählen Sie aus: Kapselungshierarchie: Fügen Sie die Elemente Containerhierarchie hinzu. Verweisen auf Methoden: Hinzufügen von Methoden, die dieses Feld verweisen.
Kompilierte .NET-Assemblys (DLL- oder EXE-Datei) oder Binärdateien	Verwenden Sie Architektur-Explorer, um Elemente und Beziehungen mit dem Diagramm zu suchen und zu ziehen.

So fügen Sie einen Link zwischen vorhandenen Knoten hinzufügen

1. Wählen Sie den Quellknoten aus.

   Start einer Symbolleiste, über dem Knoten angezeigt.

   

2. Wählen Sie in der Symbolleiste Neuen Link von diesem Knoten zu dem Knoten erstellen, auf den Sie als Nächstes klicken aus.Wählen Sie den Zielknoten aus.

   Ein Link wird zwischen den zwei Knoten.

Fügen Sie Kommentare Diagramm hinzu

1. Wählen Sie den Knoten, in dem Sie einen verknüpften Kommentar hinzufügen möchten.

   Start einer Symbolleiste, über dem Knoten angezeigt.

   

2. Wählen Sie in der Symbolleiste Neuen Kommentarknoten mit einem neuen Link zum ausgewählten Knoten erstellen aus.

3. Geben Sie Kommentare ein.Um auf eine neue Zeile einzugeben, drücken Sie UMSCHALT+EINGABETASTE.

Löschen Sie Knoten

Sie können Knoten aus einem Diagramm löschen, ohne den zugrunde liegenden Code zu beeinflussen.Um einen Knoten zu löschen, wählen Sie den Knoten aus, und drücken Sie dann die Löschen Schlüssel.Wenn Sie Knoten löschen, werden die Definitionen aus der Datei DGML (DGML-Datei) entfernt.

Wenn Sie Knoten aus einer Gruppe löschen, wird die Schaltfläche Untergeordnete Elemente erneut abrufen in der Gruppe.Um fehlende Knoten abzurufen, wählen Sie Untergeordnete Elemente erneut abrufen.Diagramme, die erstellt werden, indem das DGML bearbeitet und nicht definierte Knoten hinzugefügt werden oder indem Sie frühere Versionen von Visual Studio Ultimate verwendet, unterstützen diese Funktion nicht.

Vorsicht
Bevor Sie ein Diagramm gemeinsam verwenden, die mit Visual Studio Ultimates mit denen erstellt wurde, die Visual Studio Premium oder Visual Studio Professional verwenden, stellen Sie sicher, dass alle Knoten, die Sie andere finden möchten, im Diagramm sichtbar sind.Andernfalls sind diese Benutzer nicht in der Lage, gelöschte Knoten abzurufen.

Gruppieren Sie Knoten

To	Auszuführende Schritte
Zeigen Sie Containerknoten als Gruppenknoten oder -Endknoten an	Um Containerknoten als Endknoten anzuzeigen, wählen Sie die Knoten aus.Öffnen Sie das Kontextmenü für die Auswahl.Wählen Sie Gruppe, In Blatt konvertieren aus. Um Containerknoten als Gruppenknoten anzuzeigen, wählen Sie die Knoten aus.Öffnen Sie das Kontextmenü für die Auswahl.Wählen Sie Gruppe, in Gruppe konvertieren aus. Um alle Blattknoten als Gruppenknoten anzuzeigen, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gruppe, Gruppierung aktivieren aus. Um alle Gruppenknoten als Endknoten anzuzeigen, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gruppe, Gruppierung deaktivieren aus.
Fügen Sie einen Knoten einer Gruppe hinzu	Ziehen Sie den Knoten auf die Gruppe. Sie können Knoten aus einer Gruppe out ziehen.
Fügen Sie einen Knoten einem NichtGruppenknoten hinzu	Sie können einen beliebigen Knoten in eine Gruppe konvertieren.Ziehen Sie den Knoten auf den Zielknoten.
Gruppieren Sie ausgewählte Knoten	Wählen Sie die Knoten aus, die Sie gruppieren möchten. Start einer Symbolleiste, über den Knoten angezeigt. Wählen Sie in der Symbolleiste Ausgewählte Knoten gruppieren aus. - oder - Öffnen Sie das Kontextmenü für die Auswahl.Wählen Sie Gruppe, Übergeordnete Gruppe hinzufügen aus. Öffnen Sie das Kontextmenü für die neue Gruppe.Wählen Sie Eigenschaften aus.Benennen Sie die Gruppe in der Eigenschaft Bezeichnung um.
Gruppieren Sie Knoten, die bestimmte Kategorien oder Eigenschaften haben	Klicken Sie im Menü Architektur wählen Sie Fenster, Architektur-Explorer aus. Suchen Sie mithilfe des Architektur-Explorers nach allen zu gruppierenden Knoten, und wählen Sie sie aus. Siehe Suchen von Code im Architektur-Explorer. Klicken Sie auf der rechten Seite der aktuellen Spalte wählen Sie die reduzierte Aktionsspalte, um sie zu erweitern.(Tastatur: Drücken Sie Registerkarte, um den Fokus auf die reduzierte Aktionsspalte zu verschieben erweitert.) Hinweis Die Aktionsspalte wird markiert, wenn Sie den Zeiger verschieben, oder den Fokus, auf sie aus. Klicken Sie in der Aktionsspalte auf Enthalten in.(Tastatur: Drücken Sie zum Registerkarte verschiebt und danach die Pfeiltasten, bis die Enthalten in Beziehung ausgewählt ist). Ziehen Sie die Containergruppen aus der nächsten Spalte in das Diagramm. Öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gruppe, Gruppierung aktivieren aus.
Gruppieren von Knoten nach Eigenschaftswerten	Speichern Sie das Diagramm als DGML-Datei auf einem Datenträger. Klicken Sie im Menü Architektur.Wählen Sie Fenster, Architektur-Explorer aus. In Architektur-Explorer unter Dateisystem, wählen Sie Dateien auswählen aus. Wählen Sie in der nächsten Spalte die gespeicherte DGML-Datei aus Verwenden Sie Architektur-Explorer, um alle Knoten zu suchen und auszuwählen, die Sie gruppieren möchten. Siehe Suchen von Code im Architektur-Explorer. Klicken Sie auf der rechten Seite der aktuellen Spalte wählen Sie die reduzierte Aktionsspalte, um sie zu erweitern.(Tastatur: Drücken Sie Registerkarte, um den Fokus auf die reduzierte Aktionsspalte zu verschieben erweitert.) Hinweis Die Aktionsspalte wird hervorgehoben, wenn Sie den Mauszeiger über die Spalte bewegen. In der Aktionsspalte unter Gruppierung, wählen Sie Nach Eigenschaften gruppieren aus.(Tastatur: Drücken Sie zum Registerkarte verschiebt und danach die Pfeiltasten, bis der Befehl Nach Eigenschaften gruppieren ausgewählt ist). Wählen Sie in der nächsten Spalte die Eigenschaften aus, die Sie als Gruppen verwenden möchten. Die nächste Spalte wird mit den verfügbaren Eigenschaftswerten angezeigt. Ziehen Sie die Eigenschaftswertgruppen aus der nächsten Spalte in das Diagramm. Öffnen Sie das Kontextmenü für die Diagrammoberfläche.Wählen Sie Gruppe, Gruppierung aktivieren aus.
Entfernen von Gruppen	Wählen Sie die Gruppe oder Gruppen aus, die Sie entfernen möchten.Öffnen Sie das Kontextmenü für die Auswahl.Wählen Sie Gruppe, Gruppe entfernen aus.
Entfernen von Knoten ab der übergeordneten Gruppe bis hin zur zweiten übergeordneten Ebene oder außerhalb einer Gruppe, sofern keine Gruppe der zweiten übergeordneten Ebene vorhanden ist	Wählen Sie die Knoten aus, die Sie verschieben möchten.Öffnen Sie das Kontextmenü für die Auswahl.Wählen Sie Gruppe, Aus übergeordnetem Element entfernen aus.

So fügen Sie Knoten durch Bearbeiten der DGML-Datei des Diagramms gruppieren

1. Um einen Knoten zu einer Gruppe zu konvertieren, öffnen Sie das Kontextmenü für den Knoten.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms und das <Node/>-Element für diesen Knoten hervorgehoben.

   - oder -

   So fügen Sie eine neue Gruppe hinzu:

   1. Öffnen Sie das Kontextmenü für einen leeren Bereich des Diagramms.Wählen Sie Gehe zu, DGML aus.

   2. Fügen Sie im <Nodes>-Abschnitt ein neues <Node/>-Element hinzu.

2. Fügen Sie im <Node/>-Element ein Group-Attribut hinzu, um anzugeben, ob die Gruppe erweitert oder reduziert angezeigt werden soll.Beispiel:

   <Nodes>
      <Node Id="MyFirstGroup" Group="Expanded" />
      <Node Id="MySecondGroup" Group="Collapsed" />
   </Nodes>
   

3. Vergewissern Sie sich im <Links>-Abschnitt, dass für jede Beziehung zwischen einem Gruppenknoten und den jeweiligen untergeordneten Knoten ein <Link/>-Element mit den folgenden Attributen vorhanden ist:

   • Ein Source-Attribut, das den Gruppenknoten angibt

   • Ein Target-Attribut, das den untergeordneten Knoten angibt

   • Ein Category-Attribut, das eine Contains-Beziehung zwischen dem Gruppenknoten und seinem untergeordneten Knoten angibt

   Beispiel:

   <Links>
      <Link Category="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildOne" />
      <Link Category ="Contains" Source="MyFirstNewGroup" Target="FirstGroupChildTwo" />
      <Link Category ="Contains" Source="MySecondNewGroup" Target="SecondGroupChildOne" />
      <Link Category="Contains" Source="MySecondNewGroup" Target="SecondGroupChildTwo" />
   </Links>
   

   Weitere Informationen zum Category-Attribut finden Sie unter Zuweisen von Kategorien zu Knoten und Links.

Führen Sie Diagramme zusammen

Sie können Diagramme zusammenführen, indem Sie Knoten zwischen Diagrammen kopieren und einfügen.Wenn die Knotenbezeichner übereinstimmen, Knoten dann einfügen funktioniert wie eine Zusammenführung.Um diese Aufgabe zu vereinfachen, setzen Sie alle Assemblys oder Binärdateien die im gleichen Ordner visualisieren möchten damit der vollständige Pfad jeder Assembly oder Binärdatei für jedes Diagramm ist das Sie zusammenführen möchten.

Alternativ können Sie ein einzelnes Diagramm für die Assemblys oder Binärdateien erstellen, die Sie visuell darstellen möchten, indem Sie die folgenden Schritte ausführen:

• Ziehen Sie die Assemblys oder Binärdateien auf denselben Diagramm.

  - oder -

• Öffnen Sie Architektur-Explorer.Die Dateisystem wählen Sie Dateien auswählen, um zu suchen, und öffnen Sie die Assemblys oder Binärdateien.Um das Diagramm zu verfeinern, wählen Sie bestimmte Elemente aus die Sie visuell darstellen möchten.Wenn Sie fertig sind, wählen Sie Neues Diagrammdokument aus allen ausgewählten Knoten erstellen auf der Symbolleiste Architektur-Explorer aus.

Ändern des Diagrammstils

Sie können die Hintergrundfarbe und die Rahmenfarbe des Diagramms ändern, indem Sie die DGML-Datei des Diagramms bearbeiten.Informationen zum Ändern des Stils von Knoten und Links finden Sie unter Ändern des Stils von Knoten und Links.

1. Öffnen Sie das Kontextmenü auf der Diagrammoberfläche.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms.

2. Fügen Sie im <DirectedGraph>-Element beliebige der folgenden Attribute hinzu, um den Stil zu ändern:

   Zu änderndes Merkmal	Hinzuzufügendes Attribut
   Hintergrundfarbe	Background="ColorNameOrHexadecimalValue"
   Rahmenfarbe	Stroke="StrokeValue"

   Beispiel:

   <DirectedGraph Background="Green" xmlns="https://schemas.microsoft.com/vs/2009/dgml" >
      ...
      ...
   </DirectedGraph>
   

Ändern des Stils von Knoten und Links

Sie können die Symbole für Knoten sowie die Farbe von Knoten und Links ändern.Verwenden Sie hierzu entweder vordefinierte Farben und Symbole, oder geben Sie benutzerdefinierte Farben/Symbole an, indem Sie die DGML-Datei des Diagramms bearbeiten.Siehe Wenden Sie benutzerdefinierte Stile auf Knoten und Links.

So können Sie beispielsweise eine Farbe auswählen, um Knoten und Links hervorzuheben, die eine bestimmte Kategorie oder Eigenschaft besitzen.Dadurch können Sie bestimmte Bereiche des Diagramms kennzeichnen und sich auf diese Bereiche konzentrieren.

So wenden Sie eine vordefinierte Farbe oder ein vordefiniertes Symbol auf Knoten mit einer bestimmten Kategorie oder Eigenschaft an

1. Wenn das Feld Legende nicht sichtbar ist, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Legende anzeigen aus.

2. Überprüfen Sie im Feld Legende, ob die Knotenkategorie oder -eigenschaft in der Liste enthalten ist.

3. Wenn die Liste nicht die Kategorie oder Eigenschaft umfasst, wählen Sie + im Feld Legende, Knotenkategorie oder Knoteneigenschaft und die Kategorie oder Eigenschaft aus.

   Die Kategorie oder Eigenschaft wird nun im Feld Legende.

   Hinweis
   Informationen zum Erstellen einer Kategorie sowie zum Zuweisen einer Kategorie zu einem Knoten finden Sie unter Zuweisen von Kategorien zu Knoten und Links.Informationen zum Erstellen einer Eigenschaft sowie zum Zuweisen einer Eigenschaft zu einem Knoten finden Sie unter Zuweisen von Eigenschaften zu Knoten und Links.

4. Im Feld Legende öffnen Sie die Dropdownliste neben der Kategorie oder Eigenschaft an.

5. Orientieren Sie sich beim Auswählen des zu ändernden Stils an der folgenden Tabelle:

   Zu änderndes Merkmal	Choose
   Hintergrundfarbe	Hintergrund
   Umrissfarbe	Stroke
   Textfarbe	Foreground
   Symbol	Symbole

   Das Feld Farbpalettenauswahl angezeigt wird, damit Sie eine Farbe auswählen (oder Symbol).

6. Im Dialogfeld Farbpalettenauswahl führen Sie eine der folgenden Optionen aus:

   Anzuwendendes Merkmal	Auszuführende Schritte
   Farbsatz (oder Symbole	Öffnen Sie die Liste Farbe auswählen (oder Symbol) set.Wählen Sie einen Satz von Farben aus (oder Symbole). Um die Standardfarbe (oder das Symbol), in der Liste Farbe auswählen (Symbol) set wiederherzustellen, wählen Sie Keine.
   Bestimmte Farbe (oder bestimmtes Symbol)	Öffnen Sie die Kategorien- oder Eigenschaftswertliste.Wählen Sie eine Farbe aus (oder Symbol).

   Hinweis
   Im Feld Legende können Stile neu angeordnet, gelöscht oder vorübergehend deaktiviert werden.Siehe Ändern Sie das Legenden-Feld.

So wenden Sie eine vordefinierte Farbe auf Links mit einer bestimmten Kategorie oder Eigenschaft an

1. Wenn das Feld Legende nicht sichtbar ist, öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Legende anzeigen aus.

2. Überprüfen Sie im Feld Legende, ob die Kategorie oder Eigenschaft in der Liste enthalten ist.

3. Wenn die Liste nicht die Kategorie oder Eigenschaft umfasst, wählen Sie + im Feld Legende, Linkkategorie oder Linkeigenschaft und die Kategorie oder Eigenschaft aus.

   Die Kategorie oder Eigenschaft wird nun im Feld Legende.

   Hinweis
   Informationen zum Erstellen einer Kategorie sowie zum Zuweisen einer Kategorie zu einem Link finden Sie unter Zuweisen von Kategorien zu Knoten und Links.Informationen zum Erstellen einer Eigenschaft sowie zum Zuweisen einer Eigenschaft zu einem Link finden Sie unter Zuweisen von Eigenschaften zu Knoten und Links.

4. Im Feld Legende öffnen Sie die Liste neben der Kategorie oder Eigenschaft an.

5. Ausgewähltes Strich, um den der Kontur Links und der Pfeilspitzenfarbe zu ändern.

   Das Feld Farbpalettenauswahl angezeigt wird, damit Sie eine Farbe auswählen.

6. Im Feld Farbpalettenauswahl führen Sie eine der folgenden Optionen aus:

   Anzuwendendes Merkmal	Auszuführende Schritte
   Farbsatz	Öffnen Sie die Liste Farbe auswählenset.Wählen Sie einen Satz von Farben aus. Um die Standardfarbe, in der Liste Farbsatz auswählen wiederherzustellen, wählen Sie Keine.
   Bestimmte Farbe	Öffnen Sie die Typ- oder Eigenschaftswertliste, um eine Farbe auszuwählen.

   Hinweis
   Im Feld Legende können Stile neu angeordnet, gelöscht oder vorübergehend deaktiviert werden.Siehe Ändern Sie das Legenden-Feld.

Anwenden benutzerdefinierter Stile auf Knoten und Links

Benutzerdefinierte Stile können auf die folgenden Elemente angewendet werden:

• Einzelne Knoten und Links

• Gruppen von Knoten und Links

• Gruppen von Knoten und Links auf der Grundlage bestimmter Bedingungen

So wenden Sie einen benutzerdefinierten Stil auf einen einzelnen Knoten an

1. Öffnen Sie das Kontextmenü für den Knoten, dessen Format Sie anpassen möchten.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms und das <Node/>-Element für diesen Knoten hervorgehoben.

2. Fügen Sie im <Node/>-Element beliebige der folgenden Attribute hinzu, um den Stil anzupassen:

   Zu änderndes Merkmal	Hinzuzufügendes Attribut
   Hintergrundfarbe	Background="ColorNameOrHexadecimalValue"
   Umriss	Stroke="ColorNameOrHexadecimalValue"
   Umrissstärke	StrokeThickness="StrokeValue"
   Textfarbe	Foreground="ColorNameOrHexadecimalValue"
   Symbol	Icon="IconFilePathLocation"
   Textgröße	FontSize="FontSizeValue"
   Texttyp	FontFamily="FontFamilyName"
   Textbreite	FontWeight="FontWeightValue"
   Textstil	FontStyle="FontStyleName" Sie können als Textformat beispielsweise Italic angeben.
   Textur	Style="Glass" - oder - Style="Plain"
   Form Um die Form durch ein Symbol zu ersetzen, legen Sie die - Eigenschaft auf ShapeNone fest und legen Sie die - Eigenschaft auf den Pfad Icon mit der Symboldatei fest.	Shape="ShapeFilePathLocation"

   Beispiel:

   <Nodes>
      <Node Id="MyNode" Background="#FF008000" Stroke="#FF000000"
      Foreground="#FFFFFFFF" Icon="...\Icons\Globe.png"/>
   </Nodes>
   

So wenden Sie einen benutzerdefinierten Stil auf einen einzelnen Link an

1. Klicken Sie im Diagramm den Mauszeiger auf den Link.Eine QuickInfo angezeigt und identifiziert den Quellknoten und den Zielknoten des Links.(Tastatur: Drücken SieRegisterkarte bis Fokus ist auf den Link.)

2. Öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms.

3. Suchen Sie das <Link/>-Element, das sowohl den Namen des Quellknotens als auch den Namen des Zielknotens enthält.

4. Fügen Sie im <Link/>-Element beliebige der folgenden Attribute hinzu, um den Stil anzupassen:

   Zu änderndes Merkmal	Hinzuzufügendes Attribut
   Umriss und Pfeilspitzenfarbe	Stroke="ColorNameOrHexadecimalValue"
   Umrissstärke	StrokeThickness="StrokeValue"
   Umrissstil	StrokeDashArray="StrokeArrayValues"

   Beispiel:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" Background="Green" Stroke="#FF000000" StrokeDashArray="2,2"/>
   </Links>
   

So wenden Sie benutzerdefinierte Stile auf eine Gruppe von Knoten oder Links an

1. Weisen Sie den Knoten oder Links die gewünschten Kategorien oder Eigenschaften zu.

   Tipp
   Wenn Sie das Wiederholen von Formaten in vielen Knoten oder Links haben, könnten Sie, eine Kategorie zu diesen Knoten oder Links zu anzuwenden, und ein Format zu dieser Kategorie dann anzuwenden.Weitere Informationen finden Sie unter Zuweisen von Kategorien zu Knoten und Links sowie unter Zuweisen von Eigenschaften zu Knoten und Links.

2. Öffnen Sie das Kontextmenü für die Diagrammoberfläche.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms.

3. Sollte kein <Styles></Styles>-Element vorhanden sein, fügen Sie unter dem <DirectedGraph></DirectedGraph>-Element nach dem <Links></Links>-Element eines hinzu.

4. Geben Sie im <Styles></Styles>-Element unter dem <Style/>-Element die folgenden Attribute an:

   • TargetType="Node | Link | Graph"

   • GroupLabel="Name im Feld "Legende""

   • ValueLabel="Name im Stilauswahlfeld"

   Verwenden Sie keine Bedingung, wenn Sie einen benutzerdefinierten Stil auf alle Zieltypen anwenden möchten.

So wenden Sie einen bedingten Stil auf Gruppen von Knoten oder Links an

1. Fügen Sie im <Style/>-Element ein <Condition/>-Element mit einem Expression-Attribut hinzu, um einen Ausdruck anzugeben, von dem ein boolescher Wert zurückgegeben wird.

   Beispiel:

   <Condition Expression="MyCategory"/>
   

   - oder -

   <Condition Expression="MyCategory > 100"/>
   

   - oder -

   <Condition Expression="HasCategory('MyCategory')"/>
   

   In diesem Ausdruck wird die folgende BNF-Syntax (Backus-Naur-Form) verwendet:

   <Expression> ::= <BinaryExpression> | <UnaryExpression> | "("<Expression>")" | <MemberBindings> | <Literal> | <Number>

   <BinaryExpression> ::= <Expression> <Operator> <Expression>

   <UnaryExpression> ::= "!" <Expression> | "+" <Expression> | "-" <Expression>

   <Operator> ::= "<" | "<=" | "=" | ">=" | ">" | "!=" | "or" | "and" | "+" | "*" | "/" | "-"

   <MemberBindings> ::= <MemberBindings> | <MemberBinding> "." <MemberBinding>

   <MemberBinding> ::= <MethodCall> | <PropertyGet>

   <MethodCall> ::= <Identifier> "(" <MethodArgs> ")"

   <PropertyGet> ::= Bezeichner

   <MethodArgs> ::= <Expression> | <Expression> "," <MethodArgs> | <leer>

   <Identifier> ::= [^.]*

   <Literal> ::= Zeichenfolgenliteral in einzelnen oder doppelten Anführungszeichen

   <Number> ::= Zeichenfolge mit Ziffern und optionalem Dezimaltrennzeichen

   Sie können mehrere <Condition/>-Elemente angeben, die erfüllt sein müssen, das Format anwenden.

2. Fügen Sie in der nächsten Zeile nach dem <Condition/>-Element mindestens ein <Setter/>-Element hinzu, um ein Property-Attribut anzugeben, sowie ein festes Value-Attribut oder ein berechnetes Expression-Attribut, das auf das Diagramm, auf die Knoten oder auf die Links angewendet werden soll, von dem bzw. von denen die Bedingung erfüllt wird.

   Beispiel:

   <Setter Property="BackGround" Value="Green"/>
   

Im folgenden einfachen und umfassenden Beispiel wird durch die Bedingung angegeben, dass ein Knoten abhängig davon, ob die Passed-Kategorie auf True oder False festgelegt ist, grün bzw. rot dargestellt werden soll:

<?xml version="1.0" encoding="utf-8"?>
<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml">
   <Nodes>
      <Node Id="MyFirstNode" Passed="True" />
      <Node Id="MySecondNode" Passed="False" />
   </Nodes>
   <Links>
   </Links>
   <Styles>
      <Style TargetType="Node" GroupLabel="Passed" ValueLabel="True">
         <Condition Expression="Passed='True'"/>
         <Setter Property="Background" Value="Green"/>
      </Style>
      <Style TargetType="Node" GroupLabel="Passed" ValueLabel="False">
         <Condition Expression="Passed='False'"/>
         <Setter Property="Background" Value="Red"/>
      </Style>
   </Styles>
</DirectedGraph>

Die folgende Tabelle enthält einige Beispielbedingungen, die Sie verwenden können:

To	DGML-Beispiel
Festlegen des Schriftgrads als Funktion der Anzahl von Codezeilen, durch die auch die Größe des Knotens geändert wird.In diesem Beispiel werden mehrere Eigenschaften (FontSize und FontFamily) mithilfe eines einzelnen bedingten Ausdrucks festgelegt.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Class1" LinesOfCode ="200" /> <Node Id="Class2" LinesOfCode ="1000" /> <Node Id="Class3" LinesOfCode ="20" /> </Nodes> <Properties> <Property Id="LinesOfCode" Label="LinesOfCode" Description="LinesOfCode" DataType="System.Int32" /> </Properties> <Styles> <Style TargetType="Node" GroupLabel="LinesOfCode" ValueLabel="Function"> <Condition Expression="LinesOfCode &gt; 0" /> <Setter Property="FontSize" Expression="Math.Max(9,Math.Sqrt(LinesOfCode))" /> <Setter Property="FontFamily" Value="Papyrus" /> </Style> </Styles> </DirectedGraph>
Festlegen der Hintergrundfarbe eines Knotens auf Basis der Coverage-Eigenschaft.Die Stile werden – ähnlich wie if-else-Anweisungen – in der Anzeigereihenfolge ausgewertet. In diesem Beispiel: Legen Sie die Background-Eigenschaft auf Grün fest, wenn Coverage größer 80 ist. Legen Sie die Background-Eigenschaft abhängig vom Wert der Coverage-Eigenschaft auf einen Orangeton fest, wenn Coverage größer 50 ist. Legen Sie die Background-Eigenschaft abhängig vom Wert der Coverage-Eigenschaft auf Rot fest.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Class1" Coverage="58" /> <Node Id="Class2" Coverage="95" /> <Node Id="Class3" Coverage="32" /> </Nodes> <Properties> <Property Id="Coverage" Label="Coverage" Description="Code coverage as a percentage of blocks" DataType="Double" /> </Properties> <Styles> <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Good"> <Condition Expression="Coverage &gt; 80" /> <Setter Property="Background" Value="Green" /> </Style> <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="OK"> <Condition Expression="Coverage &gt; 50" /> <Setter Property="Background" Expression="Color.FromRgb(180 * Math.Max(1, (80 - Coverage) / 30), 180, 0)" /> </Style> <Style TargetType="Node" GroupLabel="Coverage" ValueLabel="Bad"> <Setter Property="Background" Expression="Color.FromRgb(180, 180 * Coverage / 50, 0)" /> </Style> </Styles> </DirectedGraph>
Legen Sie die Shape-Eigenschaft auf None fest, sodass die Form durch das Symbol ersetzt wird.Geben Sie mithilfe der Icon-Eigenschaft den Ort des Symbols an.	<DirectedGraph xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Automation" Category="Test" Label="Automation" /> <Node Id="C# Provider" Category="Provider" Label="C# Provider" /> </Nodes> <Categories> <Category Id="Provider" Icon="...\Icons\Module.png" Shape="None" /> <Category Id="Test" Icon="...\Icons\Page.png" Shape="None" /> </Categories> <Properties> <Property Id="Icon" DataType="System.String" /> <Property Id="Label" Label="Label" Description="Displayable label of an Annotatable object" DataType="System.String" /> <Property Id="Shape" DataType="System.String" /> </Properties> <Styles> <Style TargetType="Node" GroupLabel="Group" ValueLabel="Has category"> <Condition Expression="HasCategory('Group')" /> <Setter Property="Background" Value="#80008080" /> </Style> <Style TargetType="Node"> <Setter Property="HorizontalAlignment" Value="Center" /> </Style> </Styles> </DirectedGraph>

Ändern des Felds "Legende"

Im Feld Legende können Stile neu angeordnet, gelöscht oder vorübergehend deaktiviert werden:

1. Öffnen Sie das Kontextmenü für ein Format im Feld Legende.

2. Führen Sie eine der folgenden Aufgaben aus:

   To	Choose
   Verschieben des Stils nach oben	Nach oben
   Verschieben des Elements nach unten	Nach unten
   Löschen des Elements	ENTF
   Deaktivieren des Elements	Deaktivieren
   Reaktivieren des Elements	Aktivieren

Kopieren von Stilen aus einem Diagramm in ein anderes Diagramm

1. Stellen Sie sicher, dass das Feld Legende im Quelldiagramm angezeigt wird.Wenn es nicht sichtbar ist, öffnen Sie das Kontextmenü für einen leeren Bereich des Quelldiagramms.Wählen Sie Legende anzeigen aus.

2. Öffnen Sie das Kontextmenü für das Feld Legende.Wählen Sie Legende kopieren aus.

3. Fügen Sie die Legende auf das Zieldiagramm ein.

Zuweisen von Eigenschaften zu Knoten und Links

Sie können Knoten und Links organisieren, indem Sie ihnen Eigenschaften zuweisen.So können Sie beispielsweise Knoten auswählen, die über bestimmte Eigenschaften verfügen, um diese Knoten zu gruppieren, ihren Stil zu ändern oder sie auszublenden.

So weisen Sie einem Knoten eine Eigenschaft zu

1. Öffnen Sie das Kontextmenü für den Knoten.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms und das <Node/>-Element für diesen Knoten hervorgehoben.

2. Geben Sie im <Node/>-Element den Namen der Eigenschaft und deren Wert an.Beispiel:

   <Nodes>
      <Node Id="MyNode" MyPropertyName="PropertyValue" />
   </Nodes>
   

3. Fügen Sie dem <Properties>-Abschnitt ein <Property/>-Element hinzu, um Attribute wie den angezeigten Namen und den Datentyp anzugeben:

   <Properties>
      <Property Id="MyPropertyName" Label="My Property" DataType="System.DataType"/>
   </Properties>
   

So weisen Sie einem Link eine Eigenschaft zu

1. Klicken Sie im Diagramm den Mauszeiger auf den Link.Eine QuickInfo angezeigt und identifiziert den Quellknoten und den Zielknoten des Links.(Tastatur: Drücken Sie Registerkarte, bis der Fokus auf den Link ist.)

2. Öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms.

3. Suchen Sie das <Link/>-Element, das sowohl den Namen des Quellknotens als auch den Namen des Zielknotens enthält.

4. Geben Sie im <Node/>-Element den Namen der Eigenschaft und deren Wert an.Beispiel:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" MyPropertyName="PropertyValue" />
   </Links>
   

5. Fügen Sie dem <Properties>-Abschnitt ein <Property/>-Element hinzu, um Attribute wie den angezeigten Namen und den Datentyp anzugeben:

   <Properties>
      <Property Id="MyPropertyName" Label="My Property Name" DataType="System.DataType"/>
   </Properties>
   

Zuweisen von Kategorien zu Knoten und Links

Sie können Knoten organisieren, indem Sie ihnen Kategorien zuweisen.So können Sie beispielsweise Knoten auswählen, die sich in bestimmten Kategorien befinden, um diese Knoten zu gruppieren, ihren Stil zu ändern oder sie auszublenden.Sie können Links mit bestimmten Kategorien hervorheben.Weitere Informationen finden Sie in den folgenden Abschnitten:

• Gruppieren Sie Knoten

• Ändern des Stils von Knoten und Links

• Aus- oder Einblenden von Knoten

So weisen Sie einem Knoten eine Kategorie zu

• So fügen Sie eine vordefinierte Kategorie, z Kategorie 1 zuzuweisen, öffnen das Kontextmenü für den Knoten.Wählen Sie Kategorisieren und eine vordefinierte Kategorie aus.

- oder -

• So erstellen Sie eine benutzerdefinierte Kategorie und weisen sie zu:

  • Wählen Sie den Knoten, den Sie sortieren möchten.Drücken Sie F4, um das Fensters Eigenschaften zu öffnen.Geben Sie den Kategorienamen in der Eigenschaft Neue Kategorie des Knotens ein.Drücken Sie die EINGABETASTE.

  - oder -

  1. Öffnen Sie das Kontextmenü für den Knoten.Wählen Sie Gehe zu, DGML aus.

     Visual Studio öffnet die DGML-Datei des Diagramms und das <Node/>-Element für diesen Knoten hervorgehoben.

  2. Fügen Sie im <Node/>-Element ein Category-Attribut hinzu, um den Namen der Kategorie anzugeben.Beispiel:

     <Nodes>
        <Node Id="MyNode" Category="MyCategory" />
     </Nodes>
     

  3. Fügen Sie dem <Categories>-Abschnitt ein <Category/>-Element hinzu, damit Sie mithilfe des Label-Attributs den Anzeigetext für diese Kategorie angeben können:

     <Categories>
        <Category Id="MyCategory" Label="My Category" />
     </Categories>
     

So weisen Sie einem Link eine Kategorie zu

1. Bewegen Sie im Diagramm den Mauszeiger auf den Link, um die QuickInfo anzuzeigen und den Quellknoten sowie den Zielknoten des Links zu ermitteln.(Tastatur: Drücken Sie Registerkarte, bis der Fokus auf den Link ist.)

2. Öffnen Sie das Kontextmenü für das Diagramm.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms.

3. Suchen Sie das <Link/>-Element, das sowohl den Namen des Quellknotens als auch den Namen des Zielknotens enthält.

4. Fügen Sie im <Link/>-Element ein Category-Attribut hinzu, um den Namen der Kategorie anzugeben.Beispiel:

   <Links>
      <Link Source="MyFirstNode" Target="MySecondNode" Category="MyCategory"
   </Links>
   

5. Fügen Sie dem <Categories>-Abschnitt ein <Category/>-Element hinzu, damit Sie mithilfe des Label-Attributs den Anzeigetext für diese Kategorie angeben können:

   <Categories>
      <Category Id="MyCategory" Label="My Category" />
   </Categories>
   

Sie können hierarchische Kategorien erstellen, um die Organisation der Knoten zu vereinfachen, und untergeordneten Kategorien mithilfe der Vererbung Attribute hinzufügen.

So erstellen Sie hierarchische Kategorien

• Fügen Sie ein <Category/>-Element für die übergeordnete Kategorie hinzu, und fügen Sie anschließend dem <Category/>-Element der untergeordneten Kategorie das BasedOn-Attribut hinzu.

  Beispiel:

  <Nodes>
     <Node Id="MyFirstNode" Label="My First Node" Category= "MyCategory" />
     <Node Id="MySecondNode" Label="My Second Node" />
  </Nodes>
  <Links>
     <Link Source="MyFirstNode" Target="MySecondNode" />
  </Links>
  <Categories>
     <Category Id="MyCategory" Label="My Category" BasedOn="MyParentCategory"/>
     <Category Id="MyParentCategory" Label="My Parent Category" Background="Green"/>
  </Categories>
  

  In diesem Beispiel ist der Hintergrund von MyFirstNode grün, da das Category-Attribut das Background-Attribut von MyParentCategory erbt.

Verknüpfen Sie Elemente auf Knoten oder Links die

Sie können Elemente, wie Dokumente oder URL, zu einem Knoten oder Link verknüpfen, indem Sie die DGML-Datei des Diagramms bearbeiten und ein Reference-Attribut auf <Node/>-Element für einen Knoten oder dem <Link/>-Element für einen Link hinzufügen.Sie können den Inhalt über den Knoten oder Link vom öffnen und anzeigen.Das Reference-Attribut gibt den Pfad dieses Inhalts an.Dabei kann es sich um einen relativ zum Ort der DGML-Datei angegebenen Pfad oder um einen absoluten Pfad handeln.

Vorsicht
Wenn Sie relative Pfade verwenden und die DGML-Datei auf einen anderen Speicherort verschoben wird, wird sich diese Pfade nicht mehr auf.Wenn Sie versuchen, den verknüpften Inhalt zu öffnen und anzuzeigen, tritt ein Fehler Zahl, dass der Inhalt nicht angezeigt werden kann, auf.

Möglicherweise möchten Sie die folgenden Elemente verknüpfen:

• Möglicherweise verknüpfen Sie zur Beschreibung der Änderungen an einer Klasse die URL einer Arbeitsaufgabe, eines Dokuments oder einer anderen DGML-Datei mit dem Knoten einer Klasse.

• Möglicherweise verknüpfen Sie ein Ebenendiagramm mit einem Gruppenknoten, der eine Ebene in der logischen Architektur der Software darstellt.

• Möglicherweise verknüpfen Sie ein Komponentendiagramm mit dem Knoten für eine Schnittstelle, um weitere Informationen über eine Komponente anzuzeigen, die diese Schnittstelle verfügbar macht.

• Verknüpfen Sie einen Knoten mit einer Team Foundation Server-Arbeitsaufgabe oder Fehler oder anderen Informationen, die dem Knoten beziehen.

So verknüpfen Sie ein Element mit einem Knoten

1. Klicken Sie im Diagramm öffnen Sie das Kontextmenü für den Knoten.Wählen Sie Gehe zu, DGML aus.

   Visual Studio öffnet die DGML-Datei des Diagramms und das <Node/>-Element für diesen Knoten hervorgehoben.

2. Führen Sie eine der Aufgaben aus der folgenden Tabelle aus:

   Zum Verknüpfen von	Auszuführende Schritte
   Ein einzelnes Element	Im <Node/> oder <Link/>-Element fügen Sie ein Reference-Attribut hinzu, um den Speicherort des Elements anzugeben. Hinweis Sie können nur ein Reference-Attribut pro Element haben. Beispiel: <Nodes> <Node Id="MyNode" Reference="MyDocument.txt" /> </Nodes> <Properties> <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" /> </Properties>
   Mehrere Elemente	Im <Node/> oder <Link/>-Element fügen Sie ein neues Attribut hinzu, um den Speicherort der einzelnen Verweise anzugeben. Gehen Sie im <Properties>-Abschnitt folgendermaßen vor: Fügen Sie für jeden neuen Verweistyp ein <Property/>-Element hinzu. Legen Sie das Id-Attribut auf den Namen des neuen Verweisattributs fest. Fügen Sie das IsReference-Attribut hinzu und legen es auf True fest, um den Verweis angezeigt werden auf dem Kontextmenü Gehe zu des Elements. Verwenden Sie das - Attribut Label, den Anzeigetext für das Kontextmenü Gehe zu des Elements anzugeben. Beispiel: <Nodes> <Node Id="MyNode" SequenceDiagram="MySequenceDiagram.sequencediagram" ActiveBugs="MyActiveBugs.wiq"/> </Nodes> <Properties> <Property Id="SequenceDiagram" Label="My Sequence Diagram" DataType="System.String" IsReference="True" /> <Property Id="ActiveBugs" Label="Active Bugs" DataType="System.String" IsReference="True" /> </Properties>

   Im Diagramm wird der Name des Knotens unterstrichen dargestellt.Wenn Sie das Kontextmenü für den Knoten oder den Link öffnen, sehen Sie ein Kontextmenü Gehe zu, das die verknüpften Elemente enthält, die Sie auswählen.

3. Geben Sie mithilfe des ReferenceTemplate-Attributs eine allgemeine, von mehreren Verweisen verwendete Zeichenfolge (beispielsweise eine URL) an, anstatt die Zeichenfolge im Verweis zu wiederholen.

   Mit dem ReferenceTemplate-Attribut wird ein Platzhalter für den Wert des Verweises angegeben.Im folgenden Beispiel wird im <Node/>-Element der Platzhalter {0} im ReferenceTemplate-Attribut durch den Wert des MyFirstReference-Attributs und den Wert des MySecondReference-Attributs ersetzt, um einen vollständigen Pfad zu bilden:

   <Nodes>
      <Node Id="MyNode" MyFirstReference="MyFirstDocument" MySecondReference="MySecondDocument"/>
      <Node Id="MySecondNode" MyFirstReference="AnotherFirstDocument" MySecondReference="AnotherSecondDocument"/>
   </Nodes>
   <Properties>
      <Property Id="MyFirstReference" Label="My First Document" DataType="System.String" IsReference="True" ReferenceTemplate="http://www.Fabrikam.com/FirstDocuments/{0}.asp"/>
      <Property Id="MySecondReference" Label="My Second Document" DataType="System.String" IsReference="True" ReferenceTemplate=" http://www.Fabrikam.com/SecondDocuments/{0}.asp"/>
   </Properties>
   

4. Um das referenzierte Element oder die Elemente aus dem Diagramm anzuzeigen, öffnen Sie das Kontextmenü für den Knoten oder den Link.Wählen Sie Gehe zu und dann das Element aus.

Erstellen von Aliasen für häufig verwendete Pfade

Das Ersetzen häufig verwendeter Pfade durch Aliase trägt dazu bei, die Größe der DGML-Datei und die erforderliche Zeit zum Laden und Speichern der Datei zu reduzieren.Fügen Sie zum Erstellen eines Alias am Ende der DGML-Datei einen <Paths></Paths>-Abschnitt hinzu.Fügen Sie in diesem Abschnitt ein <Path/>-Element hinzu, um einen Alias für den Pfad zu definieren:

<Paths>
   <Path Id="MyPathAlias" Value="C:\...\..." />
</Paths>

Um von einem Element in der DGML-Datei auf den Alias zu verweisen, schließen Sie den Id-Wert des <Path/>-Elements in ein Dollarzeichen ($) und Klammern (()) ein:

<Nodes>
   <Node Id="MyNode" Reference="$(MyPathAlias)MyDocument.txt" />
</Nodes>
<Properties>
   <Property Id="Reference" Label="My Document" DataType="System.String" IsReference="True" />
</Properties>

Grundlegendes zur Directed Graph Markup Language (DGML)

DGML beschreibt zyklische und azyklische gerichtete Diagramme mithilfe von einfachem XML.Ein gerichtetes Diagramm ist ein Satz von Knoten, die durch Links bzw. Ränder verbunden sind.Mithilfe von Knoten und Links können Netzwerkstrukturen dargestellt werden, z. B. Elemente in einem Softwareprojekt.Stellen Sie Informationen mithilfe von DGML visuell dar, führen Sie Komplexitätsanalysen aus, oder durchsuchen und bearbeiten Sie gerichtete Diagramme.

Knoten und Links werden als Diagrammelemente oder einfach als Elemente bezeichnet.In der folgenden Tabelle werden verschiedene in DGML verwendete Elementtypen beschrieben:

Hinweis

Wenn Sie eine DGML-Datei bearbeiten, unterstützt Sie IntelliSense beim Auffinden der für die Elemente verfügbaren Attribute und der zugehörigen Werte.Wenn Sie Farben in Attributen angeben möchten, verwenden Sie Namen für allgemeine Farben (z. B. "Blau") oder ARGB-Hexadezimalwerte (z. B. "#ffa0b1c3").DGML verwendet eine kleine Teilmenge der WPF (Windows Presentation Foundation)-Farbdefinitionsformate.Weitere Informationen finden Sie unter Colors-Klasse.

Element	Beispielformat
<DirectedGraph></DirectedGraph> Dieses Element ist das Stammelement des Dokuments mit einem gerichteten Diagramm (.dgml).Alle anderen DGML-Elemente werden innerhalb des Bereichs dieses Elements angezeigt. In der folgenden Liste werden optionale Attribute beschrieben, die eingeschlossen werden können: Background – Die Farbe des Diagrammhintergrunds. BackgroundImage – Der Speicherort der Bilddatei, die als Diagrammhintergrund verwendet werden soll. GraphDirection – Wenn das Diagramm auf das Strukturlayout festgelegt wird (Sugiyama), ordnen Sie die Knoten so an, dass die meisten der Links in die angegebene Richtung fließen: TopToBottom, BottomToTop, LeftToRight oder RightToLeft.Siehe Durchsuchen und Neuanordnen von Abhängigkeitsdiagrammen. Layout – Legen Sie das Diagramm auf die folgenden Layouts fest: None, Sugiyama (Strukturlayout), ForceDirected (schnelle Cluster) oder DependencyMatrix.Siehe Durchsuchen und Neuanordnen von Abhängigkeitsdiagrammen. NeighborhoodDistance – Wenn das Diagramm auf das Strukturlayout oder das schnelle Clusterlayout festgelegt ist, werden nur die Knoten angezeigt, die eine bestimmte Anzahl (1-7) von Links von den ausgewählten Knoten entfernt liegen.Siehe Durchsuchen und Neuanordnen von Abhängigkeitsdiagrammen. Title – Der Name des Diagramms. ZoomLevel – Die Zoomstufe, mit der das Diagramm ursprünglich angezeigt wurde.Geben Sie einen Gleitkommawert (wobei 1 gleich 100 % ist) oder Fit an, um das Diagramm an die Fenstergröße anzupassen.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" Background="Blue" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> ... </Nodes> <Links> ... </Links> <Categories> ... </Categories> <Properties> ... </Properties> </DirectedGraph>
<Nodes></Nodes> Dieses optionale Element enthält eine Liste von <Node/>-Elementen, die Knoten im Diagramm definieren.Weitere Informationen finden Sie unter dem <Node/>-Element. Hinweis Wenn Sie auf einen nicht definierten Knoten in einem <Link/>-Element verweisen, wird im Diagramm automatisch ein <Node/>-Element erstellt.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node ... /> </Nodes> <Links> <Link ... /> </Links> </DirectedGraph>
<Node/> Dieses Element definiert einen einzelnen Knoten.Es wird in der Liste der <Nodes><Nodes/>-Elemente angezeigt. Dieses Element muss die folgenden Attribute enthalten: Id – Der eindeutige Name des Knotens und der Standardwert des Label-Attributs, wenn kein separates Label-Attribut angegeben ist.Dieser Name muss mit dem Source-Attribut oder Target-Attribut des Links übereinstimmen, der darauf verweist. In der folgenden Liste werden einige optionale Attribute beschrieben, die eingeschlossen werden können: Label – Der Anzeigename des Knotens. Formatattribute.Siehe Wenden Sie benutzerdefinierte Stile auf Knoten und Links. Category – Der Name einer Kategorie, die Elemente angibt, die dieses Attribut gemeinsam verwenden.Weitere Informationen finden Sie unter dem <Category/>-Element. Property – Der Name einer Eigenschaft, die Elemente angibt, die denselben Eigenschaftswert aufweisen.Weitere Informationen finden Sie unter dem <Property/>-Element. Group – Wenn der Knoten andere Knoten enthält, legen Sie dieses Attribut auf Expanded oder Collapsed fest, um seinen Inhalt anzuzeigen oder auszublenden.Es muss ein <Link/>-Element vorhanden sein, das das Category="Contains"-Attribut einschließt und den übergeordneten Knoten als Quellknoten und den untergeordneten Knoten als Zielknoten angibt.Siehe Organisieren von Knoten in Gruppen. Visibility – Legen Sie dieses Attribut auf Visible, Hidden oder Collapsed fest.Verwendet System.Windows.Visibility.Siehe Aus- oder Einblenden von Knoten an. Reference – Legen Sie dieses Attribut fest, um es mit einem Dokument oder einer URL zu verknüpfen.Siehe Verknüpfen Sie Elemente auf Knoten.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Student" Category="Person" /> <Node Id="Passenger" Label="Instructor" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> </Nodes> <Links> <Link ... /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> </Categories> </DirectedGraph>
<Links></Links> Dieses Element enthält die Liste von <Link>-Elementen, die Links zwischen Knoten definieren.Weitere Informationen finden Sie unter dem <Link/>-Element.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Links> <Link ... /> </Links> </DirectedGraph>
<Link/> Dieses Element definiert einen einzelnen Link, der einen Quellknoten mit einem Zielknoten verbindet.Es wird in der Liste der <Links></Links>-Elemente angezeigt. Hinweis Wenn dieses Element auf einen nicht definierten Knoten verweist, wird vom Diagrammdokument automatisch ein Knoten erstellt, der über die angegebenen Attribute (sofern vorhanden) verfügt. Dieses Element muss die folgenden Attribute enthalten: Source – Der Quellknoten des Links. Target – Der Zielknoten des Links. In der folgenden Liste werden einige optionale Attribute beschrieben, die eingeschlossen werden können: Label – Der Anzeigename des Links. Formatattribute.Siehe Wenden Sie benutzerdefinierte Stile auf Knoten und Links. Category – Der Name einer Kategorie, die Elemente angibt, die dieses Attribut gemeinsam verwenden.Weitere Informationen finden Sie unter dem <Category/>-Element. Property – Der Name einer Eigenschaft, die Elemente angibt, die denselben Eigenschaftswert aufweisen.Weitere Informationen finden Sie unter dem <Property/>-Element.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Student" Category="Person" /> <Node Id="Passenger" Label="Instructor" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> </Nodes> <Links> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Link Source="Driver" Target="Car" Label="Passed" Stroke="Black" Background="Green" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Stroke="Black" Background="Red" Category="PassedTest" /> </Links> </DirectedGraph>
<Categories></Categories> In diesem Element ist die Liste der <Category/>-Elemente enthalten.Weitere Informationen finden Sie unter dem <Category/>-Element.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Categories> <Category ... /> </Categories> </DirectedGraph>
<Category/> Dieses Element definiert ein Category-Attribut, mit dem Elemente angegeben werden, die dieses Attribut gemeinsam verwenden.Ein Category-Attribut kann verwendet werden, um Diagrammelemente zu organisieren, um gemeinsame Attribute durch Vererbung bereitzustellen oder um weitere Metadaten zu definieren. Dieses Element muss die folgenden Attribute enthalten: Id – Der eindeutige Name der Kategorie und der Standardwert des Label-Attributs, wenn kein separates Label-Attribut angegeben ist. In der folgenden Liste werden einige optionale Attribute beschrieben, die eingeschlossen werden können: Label – Ein Anzeigename für die Kategorie. BasedOn – Die übergeordnete Kategorie, von der die <Category/> des aktuellen Elements erbt. Im Beispiel für dieses Element erbt die Kategorie FailedTest ihr Stroke-Attribut aus der Kategorie PassedTest.Siehe ", um hierarchische Kategorien" in Zuweisen von Kategorien zu Knoten und Links zu erstellen. Kategorien stellen auch ein bestimmtes grundlegendes Vorlagenverhalten bereit, mit dem die Darstellung von Knoten und Links bei der Anzeige in einem Diagramm gesteuert wird.Siehe Wenden Sie benutzerdefinierte Stile auf Knoten und Links.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Driver" Category="Person" /> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> <Node Id="Passenger" Category="Person" /> </Nodes> <Links> <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" /> <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" /> </Categories> </DirectedGraph>
<Properties></Properties> In diesem Element ist die Liste der <Property/>-Elemente enthalten.Weitere Informationen finden Sie unter dem <Property/>-Element.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Properties> <Property ... /> </Properties> </DirectedGraph>
<Property/> Dieses Element definiert ein Property-Attribut, mit dem Sie einem DGML-Element oder -Attribut (einschließlich von Kategorien und anderen Eigenschaften) einen Wert zuweisen können. Dieses Element muss die folgenden Attribute enthalten: Id – Der eindeutige Name der Eigenschaft und der Standardwert des Label-Attributs, wenn kein separates Label-Attribut angegeben ist. DataType – Der Typ der Daten, die von der Eigenschaft gespeichert werden. Wenn die Eigenschaft im Eigenschaftenfenster angezeigt werden soll, geben Sie mit der Label-Eigenschaft den Anzeigenamen der Eigenschaft an. Siehe Zuweisen von Eigenschaften zu Knoten und Links zu.	<?xml version="1.0" encoding="utf-8"?> <DirectedGraph Title="DrivingTest" xmlns="https://schemas.microsoft.com/vs/2009/dgml"> <Nodes> <Node Id="Driver" Label="Driver" Category="Person" DrivingAge="18"/> <Node Id="Car" Label="Car" Category="Automobile" /> <Node Id="Truck" Label="Truck" Category="Automobile" /> <Node Id="Passenger" Category="Person" /> </Nodes> <Links> <Link Source="Driver" Target="Car" Label="Passed" Category="PassedTest" /> <Link Source="Driver" Target="Truck" Label="Failed" Category="FailedTest" /> </Links> <Categories> <Category Id="Person" Background="Orange" /> <Category Id="Automobile" Background="Yellow"/> <Category Id="PassedTest" Label="Passed" Stroke="Black" Background="Green" /> <Category Id="FailedTest" Label="Failed" BasedOn="PassedTest" Background="Red" /> </Categories> <Properties> <Property Id="DrivingAge" Label="Driving Age" DataType="System.Int32" /> </Properties> </DirectedGraph>

Siehe auch

Konzepte

Visualisieren von Codeabhängigkeiten in Abhängigkeitsdiagrammen

Durchsuchen und Neuanordnen von Abhängigkeitsdiagrammen