Create UML modeling projects and diagrams

UML models help you understand, discuss, and design software systems. Visual Studio provides templates for five of the most frequently used UML diagrams: activity, class, component, sequence, and use case. In addition, you can create layer diagrams, which help you define the structure of your system.

UML modeling diagrams and layer diagrams can exist only inside a modeling project. Each modeling project contains a shared UML model and several UML diagrams. Each diagram is a partial view of the model. The UML model contains all the elements on the UML diagrams and can be viewed by using UML Model Explorer. For information about models and their relationship to diagrams, see Edit UML models and diagrams. For information about modeling projects under version control, see Manage models and diagrams under version control and Structure your modeling solution

Create a Diagram in a Modeling Project

To see which versions of Visual Studio support this feature, see Version support for architecture and modeling tools.

To create a diagram and add it to a project

1. On the Architecture menu, choose New UML or Layer Diagram.

2. In the Add New Diagram dialog box, click the type of modeling diagram that you want.

   

3. Type a name for the new diagram.

4. In the Add to modeling project box:

   • Select a modeling project that already exists in your solution, and then click OK.

     - or -

   1. Select Create a new modeling project, and then click OK.

   2. In the Create New Modeling Project dialog box, type a name and location for the new project, and then click OK.

      

      If your solution is open, the new project is added to the solution. If you have no open solution, you can type a name for a new solution.

   If you already have a modeling project, you can also use the following procedure.

To add a diagram to an existing modeling project

1. In Solution Explorer, click the modeling project node.

   Note

   The modeling project contains a model definition folder named ModelDefinition.

2. On the Project menu, click Add New Item.

3. In the Add New Item - <project name> dialog box, under Templates, click the modeling diagram type, for example, UML Component Diagram.

4. Type a name for the diagram, and then click Add.

   The modeling diagram opens and appears in the modeling project.

   Caution

   Do not add, copy, or drag existing diagram files to other modeling projects or to other locations in the solution. This causes elements to disappear from the copied diagrams or errors to occur when you open the diagrams. You must open the diagram file from the modeling project in which it was created. This is because a UML diagram is a view of the model that is owned by its modeling project. To copy a diagram file, create a new diagram, and then copy the elements from the source diagram to the new diagram. For more information, see Troubleshooting Modeling Projects and Diagrams.

To create a blank modeling project

1. On the File menu, point to New, and then click Project.

2. In the New Project dialog box, under Installed Templates, click Modeling Projects.

3. In the middle window, click Modeling Project.

4. Name the project and specify a location in the Name and Location boxes.

5. In the Solution box, select Add to Solution to add the new project to a solution you already have open; or Create new Solution to close any open solution and add the project to a new solution.

Removing Modeling Diagrams from a Project

You can permanently delete a diagram, or you can temporarily exclude a diagram from a project and then restore it.

To permanently delete a diagram from a project

• In Solution Explorer, right-click the main file that represents the diagram, and then click Delete.

  The diagram is removed from the project and the file system. The elements shown on the diagram are not removed from UML Model Explorer.

  Note

  Each diagram has two files, one subsidiary to the other. For example, if you have a component diagram with the name CD1, you should delete the file that is named CD1.componentdiagram. Its subsidiary file that is named CD1.componentdiagram.layout will be deleted automatically.

To temporarily exclude a diagram from a project

• In Solution Explorer, right-click the diagram file, and then click Exclude from Project.

  The diagram is removed from the project. It is not removed from the file system.

  Note

  The elements shown on the diagram are not removed from UML Model Explorer.

To restore a temporarily excluded diagram to a project

1. In Solution Explorer, click the modeling project node.

   Note

   The modeling project contains a model definition folder named ModelDefinition.

2. On the Project menu, click Add Existing Item.

3. In the Add Existing Item dialog box, locate the diagram file, select the file, and then click Add.

   The modeling diagram opens and appears in the modeling project.

   Note

   Each diagram has a pair of files in the file system. Do not select a file that has the extension .layout. Also, Visual Studio does not support adding existing UML diagrams to multiple modeling projects. Each diagram file must be opened within the modeling project in which it was created. This is because a UML diagram shows a view of a model that is owned by its modeling project.

Diagrams that Do Not Require Modeling Projects

The following kinds of diagrams are not part of a modeling project:

• Class diagrams that are created as views of the source code. These are not related to UML class diagrams. For more information, see Designing and Viewing Classes and Types.

• Code maps. See Map dependencies across your solutions.

• Diagrams that are not UML diagrams or layer diagrams, such as domain specific languages.

Troubleshooting Modeling Projects and Diagrams

The following table describes issues that can occur with modeling projects or diagrams and how to resolve them:

See Also

Edit UML models and diagrams Structure your modeling solution