{"id":1833,"date":"2010-07-20T10:43:00","date_gmt":"2010-07-20T10:43:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudio\/2010\/07\/20\/announcing-the-solution-navigator\/"},"modified":"2022-05-18T04:22:38","modified_gmt":"2022-05-18T11:22:38","slug":"announcing-the-solution-navigator","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/visualstudio\/announcing-the-solution-navigator\/","title":{"rendered":"Announcing the Solution Navigator"},"content":{"rendered":"

We are very excited to announce the first release of Solution Navigator, a new tool that merges functionality from Solution Explorer, Class View, Object Browser, Call Hierarchy, Navigate To, and Find Symbol References into a single view. This view can be surfaced as a tool window or, for C# and VB, an interactive tooltip.<\/p>\n

The Solution Navigator is included in the latest release of the Visual Studio Productivity Power Tools<\/a> which is a free download available on the Visual Studio Gallery<\/a>.<\/p>\n\n\n\n
\n\n\n\n\n\n\n\n\n\n\n
The Solution Navigator enables you to:<\/b><\/td>\n<\/tr>\n
Expand<\/b> code files to navigate to its classes, expand classes to navigate to their members, and so on<\/td>\n<\/tr>\n
Search<\/b> your solution, all the way down to class members<\/td>\n<\/tr>\n
Filter<\/b> your solution or projects to see just opened files, unsaved files, and so on<\/td>\n<\/tr>\n
Preview<\/b> images by hovering over them, or preview rich information by hovering over code items<\/td>\n<\/tr>\n
Scope<\/b> the view to just the project, file or class you are working on<\/td>\n<\/tr>\n
Create<\/b> multiple views of your solution so you can always access the files you need<\/td>\n<\/tr>\n
View<\/b> relationships between classes and members (such as references or callers\/calles in C#)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/td>\n\n\n\n\n\n\n\n
\n

Tool Window<\/b><\/p>\n<\/td>\n<\/tr>\n

\"1\"<\/a><\/td>\n<\/tr>\n
\n

Interactive Tooltip<\/b><\/p>\n<\/td>\n<\/tr>\n

\"2\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Let\u2019s look at each of these features in more depth.<\/p>\n

Expand code files to navigate to its classes, expand classes to navigate to their members, and so on<\/h2>\n

Traditionally users have had to work across multiple tool windows to gain both a file-based and class-based view of their solution. The Solution Navigator enables users to navigate from the solution level right down to local variables contained inside a method.<\/p>\n

Note<\/b>: Currently this is only available for C# and VB languages.<\/p>\n

\"3\"<\/a><\/p>\n

<\/h4>\n

<\/h4>\n

Search your solution, all the way down to class members<\/h2>\n

The Solution Navigator uses the \u2018Navigate To\u2019 feature to search your solution. The search results are presented as a filter in the Solution Navigator tree view, with the search term is highlighted and non-matching visible items (such as a folder containing a search result) greyed out.<\/p>\n

Users can search the entire solution or scope the search to a single project, file, class or type; Scoping is covered later on in this post.<\/p>\n\n\n\n\n
\"4\"<\/a><\/td>\n\"5\"<\/a><\/td>\n<\/tr>\n
Searching the full solution<\/td>\nScoping to a single project<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u00a0<\/b><\/p>\n

 <\/p>\n

Filter your solution or projects to see just opened files, unsaved files, and so on<\/b><\/h2>\n

The Document Well has traditionally been the primary UI for managing open files. However, users can now easily access and search through the documents that are open, unsaved, or have been edited during the current session.<\/p>\n

Open<\/h3>\n

Shows the files that are currently open.<\/p>\n

\"6\"<\/a><\/p>\n

Unsaved<\/h3>\n

Shows the files which have been edited but not saved.<\/p>\n

\"7\"<\/a><\/p>\n

Edited<\/h3>\n

Shows the files that have been edited during the current session.<\/p>\n

\"8\"<\/a><\/p>\n

Note:<\/b> The edited filter is not the same as a pending changes list; the edited list will show a file even if an edit has been reverted.<\/p>\n

Preview images by hovering over them, or preview rich information by hovering over code items<\/h2>\n

Solution Navigator provides a visual tooltip for most image files:<\/p>\n

\"9\"<\/a><\/p>\n

Scope the view to just the project, file or class you are working on<\/h2>\n

When working on large solutions, you might find yourself spending the majority of your time working with one or two classes in a single project. Scoping or \u2018re-rooting\u2019 the Solution Navigator tree view enables you to focus on the files that matter for your current task. Scoping is also useful when searching large solutions, by scoping to the project or type you are interested in.<\/p>\n

To Scope the view to the current selection in the Solution Navigator, click the re-root button on the far right of the item, or use the keyboard shortcut Ctrl<\/b> + -> <\/b>(right arrow).<\/p>\n

\"10\"<\/a><\/p>\n

 <\/p>\n\n\n\n\n
<\/td>\n\u00a0<\/td>\n\u00a0<\/td>\n<\/tr>\n
Scoped to project<\/td>\nScoped to file<\/td>\nScoped to class<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Create multiple views of your solution so you can always access the files you need<\/h2>\n

Unlike Solution Explorer, Solution Navigator enables you to create multiple instances of the tool window. This can be especially useful when working across large projects. Each tool window can have a uniquely-scoped view. These views could be focused around a single project, class or file, or even based from search results.<\/p>\n\n\n\n
\n\n\n\n\n\n
Additional views can be created by two methods:<\/td>\n<\/tr>\n
\"15\"<\/a>\u00a0 – Clicking the \u2018New Window\u2019 button on the tool window. This creates a new window with the view rooted at the current selection.<\/td>\n<\/tr>\n
\"16\"<\/a> – Clicking the \u2018Pin\u2019 button on the interactive Tooltip. This promotes the Tooltip to a tool window which can be docked.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/td>\n\"14\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

 <\/p>\n

View related information about classes and members (such as references or callers\/callees for C#)<\/h2>\n

Understanding how a particular method or class works often requires stepping through how the rest of the application interacts with it. Understanding where amethod is referenced in the solution is one of the most useful pieces of information in this task. Solution Navigator brings together some of the key relationships such as references which can exist between classes, methods, and variables and surfaces them inline.<\/p>\n

Relationships are only seen for the root item. To see class\/member relationships in the tool window, you need to re-root. The interactive tooltips are already rooted at a code item.<\/p>\n

Note:<\/b> Some relationships are available in C# only, we will be looking to increase the number of relationships and languages supported in future releases.<\/p>\n

\"17\"<\/a><\/p>\n

Relationships shown on classes:<\/h3>\n

Contains<\/span> – The members defined by the current class (e.g. methods, properties, \u2026)<\/p>\n

References<\/span> – The places where the current class is referenced in the current solution<\/p>\n

Returned By<\/span> – The methods that return instances of the current class (C# only)<\/p>\n

Derived Types<\/span> – The types that are derived from the current class (C# only)<\/p>\n

Base Types<\/span> – The types that the current class derives from (C# only)<\/p>\n

Relationships shown on methods:<\/h3>\n

Contains <\/span>– The parameters contained within the current method, plus local variables if the method is part of the current solution<\/p>\n

References<\/span> \u2013 The places where the current method is referenced in the solution<\/p>\n

Called By<\/span> \u2013 The methods that call into the current method (C# only)<\/p>\n

Calls<\/span> \u2013 The methods that are called by the current method (C# only)<\/p>\n

Relationships shown on members:<\/h3>\n

Type<\/span> – The data type of the current member<\/p>\n

References<\/span> \u2013 The places where the current member is referenced in the solution<\/p>\n

Solution Navigator Tool Window Buttons and Commands<\/h2>\n

\"18\"<\/a><\/p>\n\n\n\n\n\n\n\n\n\n\n
\"15\"<\/a><\/td>\nNew Window \u2013 This button creates a new instance of the tool window based on the current selection in the Solution Navigator<\/p>\n

 <\/td>\n<\/tr>\n

\"19\"<\/a><\/td>\nCollapse All \u2013 This button collapses all of the tree view so that only the top-level projects are visible<\/p>\n

 <\/td>\n<\/tr>\n

\"20\"<\/a><\/td>\nSend Feedback!<\/p>\n

 <\/td>\n<\/tr>\n

\"21\"<\/a><\/td>\nView as root \u2013 This button scopes the view in the in the Solution Navigator to be \u2018rooted\u2019 at the current item instead of the overall solution \u2013 see the \u201cScope\u201d section for more details.<\/p>\n

 <\/td>\n<\/tr>\n

\"22\"<\/a><\/td>\nNavigate Back \u2013 This button returns the user to the previous view shown. Navigation events only occur when the user alters the current view by performing a search, viewing a filter\/relationship or changing the root item of the view.<\/p>\n

 <\/td>\n<\/tr>\n

\"24\"<\/a><\/td>\nNavigate Forward \u2013 This button is only visible if the user has navigated back from a view. Navigation events only occur when the user alters the current view by performing a search, viewing a filter\/relationship or changing the root item of the view.<\/p>\n

 <\/td>\n<\/tr>\n

\"23\"<\/a><\/td>\nNavigate Up \u2013 This button changes the view in the Solution navigator to be rooted at the parent of the current item. This button is only visible if the user has re-scoped and to a point where the immediate parent of the current item is not the same as the previous view.<\/td>\n<\/tr>\n
<\/td>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Solution Navigator Interactive Tooltip Buttons and Commands<\/h2>\n

The purpose of the tooltip is to surface the rich relationship information from Solution Navigator inside the editor.<\/p>\n