diff --git a/docs/get-started/media/visualstudio/visual-studio-overview.png b/docs/get-started/media/visualstudio/visual-studio-overview.png new file mode 100644 index 00000000000..f4397eabec3 Binary files /dev/null and b/docs/get-started/media/visualstudio/visual-studio-overview.png differ diff --git a/docs/get-started/visual-studio-ide.md b/docs/get-started/visual-studio-ide.md index a08f7c9ee08..c730a41adc1 100644 --- a/docs/get-started/visual-studio-ide.md +++ b/docs/get-started/visual-studio-ide.md @@ -1,12 +1,15 @@ --- title: What Is Visual Studio? titleSuffix: '' -description: Explore Visual Studio, an integrated development environment (IDE) that enables you to develop, edit, debug, version control, and deploy your app. -ms.date: 09/09/2025 +description: Explore Visual Studio, an integrated development environment (IDE) that enables you to develop, build, debug, test, and deploy your apps with AI-powered assistance. +ms.date: 3/20/2026 ms.subservice: general-ide ms.topic: overview ms.update-cycle: 90-days -ms.custom: vs-acquisition +ms.custom: +- vs-acquisition +- awp-ai +- doc-kit-assisted f1_keywords: - vs.startpage - VS.StartPage.HowDoI @@ -17,16 +20,26 @@ manager: mijacobs --- # What is Visual Studio? -Visual Studio is a powerful developer tool that you can use to complete the entire development cycle in one place. It's a comprehensive integrated development environment (IDE) that you can use to write, edit, debug, and build code, and then deploy your app. Visual Studio includes compilers, code completion tools, source control, extensions, and many other features to enhance every stage of the software development process. This article provides an overview of Visual Studio. +Visual Studio is a powerful integrated development environment (IDE) for Windows where you can develop, build, debug, test, and deploy your apps, all in one place. With built-in AI assistance from [GitHub Copilot](../ide/visual-studio-github-copilot-get-started.md), you can accelerate your workflow with intelligent code completions, chat-based guidance, and AI-powered debugging. -:::image type="content" source="media/visual-studio-overview.png" alt-text="Diagram that shows the software development cycle."::: +:::image type="content" source="media/visualstudio/visual-studio-overview.png" alt-text="Diagram showing the Visual Studio development cycle: develop, build, debug, test, and deploy, with AI assistance integrated throughout."::: -With the variety of features and language support in Visual Studio, you can grow from writing your first "Hello World" program to developing and deploying apps. For example, build, debug, and test .NET and C++ apps, edit ASP.NET pages in the web designer view, develop cross-platform mobile and desktop apps with .NET, or build responsive web UIs in C#. +Visual Studio includes compilers, code completion tools, source control, extensions, and many more features to enhance every stage of the software development process. +> [!NOTE] +> Visual Studio is available for Windows. For a lightweight, cross-platform code editor, see [Visual Studio Code](https://code.visualstudio.com/). -::: moniker range="vs-2022" +## Install Visual Studio + +Visual Studio is available in three editions: + +- [Community](https://visualstudio.microsoft.com/vs/community/): Free and fully featured for students, open-source developers, and individual developers. +- [Professional](https://visualstudio.microsoft.com/vs/professional/): For individual developers or small teams. +- [Enterprise](https://visualstudio.microsoft.com/vs/enterprise/): For small-to-large business and enterprise organizations. + +[Compare features across editions](https://visualstudio.microsoft.com/vs/compare/) to find the edition that best fits your needs. -To install Visual Studio, select the following button, and [choose the edition of Visual Studio](#choose-your-visual-studio-edition) to download. +::: moniker range="vs-2022" > [!div class="button"] > [Download Visual Studio](https://aka.ms/vs/download/?cid=learn-onpage-download-cta) @@ -35,23 +48,23 @@ To install Visual Studio, select the following button, and [choose the edition o ::: moniker range="visualstudio" -To install Visual Studio, select the following button, and [choose the edition of Visual Studio](#choose-your-visual-studio-edition) to download. - > [!div class="button"] > [Download Visual Studio](https://aka.ms/vs/download/?cid=learn-onpage-download-install-visual-studio-page-cta) ::: moniker-end +For more information, see [Install Visual Studio](../install/install-visual-studio.md). + ## Why use Visual Studio? -Visual Studio provides developers with a feature-rich development environment to develop code efficiently and collaboratively. +Whether you're writing your first "Hello World" program or deploying enterprise apps, Visual Studio provides the tools you need to work efficiently and collaboratively. -- Workload-based installer. Install only what you need. -- Powerful coding tools and features. Everything you need to build your apps in one place. -- Multiple-language support. Code in C++, C#, JavaScript, TypeScript, Python, and more. -- Cross-platform development. Build apps for any platform. -- Version control integration. Collaborate on code with teammates. -- AI-assisted development. Write code efficiently with AI assistance. +- Multiple-language support. Code in C#, C++, Python, JavaScript, TypeScript, and more. +- Cross-platform development. Build mobile and desktop apps with .NET MAUI, web apps with ASP.NET, or Node.js services. +- AI-assisted development. Write, debug, and test code faster with [GitHub Copilot](../ide/visual-studio-github-copilot-extension.md). +- Workload-based installer. Install only the components you need. +- Integrated version control. Clone, branch, commit, and review pull requests by using built-in Git tooling. +- Extensible platform. Customize your IDE with extensions from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/), or [build your own](../extensibility/visualstudio.extensibility/get-started/create-your-first-extension.md). ## Discover Visual Studio @@ -59,48 +72,33 @@ Visual Studio supports different parts of the software development cycle. ### Develop your code -The Visual Studio IDE provides [features](../ide/writing-code-in-the-code-and-text-editor.md) that make it easier for you to write and manage your code with confidence. For example, you can code quickly and accurately by using [AI-assisted development](../ide/ai-assisted-development-visual-studio.md) tools. These tools include [GitHub Copilot](../ide/visual-studio-github-copilot-extension.md) and [IntelliCode](../ide/intellicode-visual-studio.md). Make quick improvements to your code by reviewing tips, indicated by a light bulb icon, that suggest actions, or expand and collapse blocks of code by using outlining. Organize and explore your code by using **Solution Explorer**, which shows your code organized by files, or **Class View**, which shows your code organized by classes. +[Visual Studio Code](../ide/writing-code-in-the-code-and-text-editor.md) helps you write and manage code with confidence. Use light bulb suggestions for quick fixes, outlining to collapse code blocks, and **Solution Explorer** or **Class View** to navigate your projects. Learn more about features in the IDE that help you organize and edit content: - [Code editor](tutorial-editor.md) -- [Personalize](../ide/personalizing-the-visual-studio-ide.md) the IDE and the editor -- [Organize code](tutorial-projects-solutions.md) - [Tips and tricks](../ide/productivity-features.md) -### AI-assisted development +### Develop with AI -[GitHub Copilot](../ide/visual-studio-github-copilot-extension.md), [GitHub Copilot Chat](../ide/visual-studio-github-copilot-chat.md), and [IntelliCode](../ide/intellicode-visual-studio.md) assist you in writing code faster and with greater accuracy, help you develop a deeper understanding of the codebase, and help with other development tasks such as writing unit tests, [debugging](../debugger/debug-with-copilot.md), and profiling. +[GitHub Copilot](../ide/visual-studio-github-copilot-get-started.md) and [IntelliCode](../ide/intellicode-visual-studio.md) assist you in writing code faster and with greater accuracy. Use [Copilot Completions](../ide/visual-studio-github-copilot-extension.md) for inline code suggestions as you type, and [Copilot Chat](../ide/visual-studio-github-copilot-chat.md) to ask questions, generate code, or refactor existing code through natural language. These tools also help with other development tasks such as writing unit tests, [debugging](../debugger/debug-with-copilot.md), and profiling. Learn more about [AI-assisted development in Visual Studio](../ide/ai-assisted-development-visual-studio.md). -Get started with GitHub Copilot in Visual Studio: - -- [Install and manage GitHub Copilot](../ide/visual-studio-github-copilot-install-and-states.md) -- [Use GitHub Copilot Completions in Visual Studio](../ide/visual-studio-github-copilot-extension.md) -- [Use GitHub Copilot Chat in Visual Studio](../ide/visual-studio-github-copilot-chat.md#use-copilot-chat-in-visual-studio) -- [Debug with Copilot](../debugger/debug-with-copilot.md) - ### Build your app -You can compile and build your applications to create builds immediately and test them in a debugger. You can run multi-processor builds for C++ and C# projects. Visual Studio also provides several options that you can configure when you build applications. You can create a custom build configuration, use the built-in configurations, hide certain warning messages, or increase build output information. - -Learn more about how to [compile and build in Visual Studio](../ide/compiling-and-building-in-visual-studio.md): +You can compile and build your applications to create builds right away and test them in a debugger. You can run multiprocessor builds for C++ and C# projects. Visual Studio also provides several options that you can configure when you build applications. You can create a custom build configuration, use the built-in configurations, hide certain warning messages, or increase build output information. -- [Create build configurations for your project](../ide/understanding-build-configurations.md) -- [Build an application](../ide/walkthrough-building-an-application.md) +Learn more about how to [compile and build in Visual Studio](../ide/compiling-and-building-in-visual-studio.md). ### Debug your code -Integrated debugging in Visual Studio enables you to easily debug, profile, and diagnose code. You can step through your code and look at the values stored in variables, set watches on variables to see when values change, and examine the execution path of your code. Visual Studio also provides other ways to debug your code while it runs. +By using integrated debugging in Visual Studio, you can easily debug, profile, and diagnose code. You can step through your code and look at the values stored in variables, set watches on variables to see when values change, and examine the execution path of your code. Visual Studio also provides other ways to debug your code while it runs. Learn more about debugging in Visual Studio: -- [Debug your app](..//debugger/debugger-feature-tour.md) -- [Debugging techniques and tools](../debugger/write-better-code-with-visual-studio.md) -- [Measure app performance](../profiling/beginners-guide-to-performance-profiling.md) +- [First look at the debugger](../debugger/debugger-feature-tour.md) - [Debug with Copilot](../debugger/debug-with-copilot.md) -- [Tips and tricks](../debugger/debugger-tips-and-tricks.md) ### Test your code @@ -109,74 +107,30 @@ You can write high-quality code by using comprehensive testing tools in Visual S Learn more about the testing tools available in Visual Studio: - [Use testing tools in Visual Studio](../test/improve-code-quality.md) -- [Create and run unit tests](../test/getting-started-with-unit-testing.md) -- [Analyze code coverage](../test/using-code-coverage-to-determine-how-much-code-is-being-tested.md) - -### Version control - -By using the integrated Git features in Visual Studio, you can clone, create, or open your own repositories. The Git tool window provides everything you need to commit and push changes, manage branches, and resolve merge conflicts. If you have a GitHub account, you can manage repos directly within Visual Studio. - -Learn more about version control in Visual Studio: +- [Get started with unit testing](../test/getting-started-with-unit-testing.md) -- [Version control with Git](../version-control/git-with-visual-studio.md) -- [Visual Studio and GitHub](https://visualstudio.microsoft.com/vs/github/) +### Collaborate and manage version control -### Collaborate +By using the integrated Git features in Visual Studio, you can clone, create, or open your own repositories. The Git tool window provides everything you need to commit and push changes, manage branches, and resolve merge conflicts. If you have a GitHub account, you can manage repos and review pull requests directly within Visual Studio. -Visual Studio Live Share enables real-time collaborative development. With Live Share, you can share your project with your peers, regardless of the language or platform. Resolve issues fast by allowing your team to connect, navigate, set break points, and type in your editor session. - -Learn more about collaborating with Live Share: - -- [Collaborate with Live Share](/visualstudio/liveshare/quickstart/share) -- [Common use cases](/visualstudio/liveshare/reference/use-cases) +Learn more about [version control with Git in Visual Studio](../version-control/git-with-visual-studio.md). ### Deploy your app When you deploy an application, service, or component, you distribute it for installation on other computers, devices, or servers, or in the cloud. You can choose the appropriate method in Visual Studio for the type of deployment that you need. Share your apps and code by publishing to the web or Azure, or by deploying to a network share or a local folder. -Learn more about how to [deploy your app by using Visual Studio](/visualstudio/deployment/): - -- [Deploy your app from Visual Studio](../deployment/deploying-applications-services-and-components.md) -- [Deploy your app to a folder, a web server, Azure, or another destination](../deployment/deploying-applications-services-and-components-resources.md) - -## Choose your Visual Studio edition - -There are three editions of Visual Studio: - -- [Community](https://visualstudio.microsoft.com/vs/community/). A free, fully featured IDE for students, open-source developers, and individual developers. -- [Professional](https://visualstudio.microsoft.com/vs/professional/). A subscription-based option for individual developers or small teams. -- [Enterprise](https://visualstudio.microsoft.com/vs/enterprise/). A subscription-based option for small-to-large business and enterprise organizations. - -[Compare features across Visual Studio editions](https://visualstudio.microsoft.com/vs/compare/) and [get the Visual Studio edition](https://visualstudio.microsoft.com/vs/pricing/) that best fits your needs. - -## Install Visual Studio - -To install Visual Studio, select the following button, and then choose the edition of Visual Studio. - - -::: moniker range="vs-2022" - - > [!div class="button"] - > [Download Visual Studio](https://aka.ms/vs/download/?cid=learn-onpage-download-cta) - -::: moniker-end - -::: moniker range="visualstudio" - - > [!div class="button"] - > [Download Visual Studio](https://aka.ms/vs/download/?cid=learn-onpage-download-install-visual-studio-page-cta) - -::: moniker-end +To learn more, see [deploy your app from Visual Studio](../deployment/deploying-applications-services-and-components.md). ## Get started -Get started with one of the following language-specific tutorials: +Choose a language-specific tutorial to start building your first app: -- [Create a simple C# console app](./csharp/tutorial-console.md) -- [Get started with Python](/visualstudio/python/installing-python-support-in-visual-studio) -- [Create a simple Visual Basic console app](./visual-basic/tutorial-console.md) -- [Create a C++ console app](/cpp/get-started/tutorial-console-cpp) -- [Create a Node.js and Express app](../javascript/tutorial-nodejs.md) +- [C#](./csharp/tutorial-console.md) — Build a simple console app and learn the basics of C# and .NET. +- [C++](/cpp/get-started/tutorial-console-cpp) — Create a C++ console app and explore the build toolchain. +- [Python](/visualstudio/python/installing-python-support-in-visual-studio) — Set up Python support and write your first script. +- [JavaScript/Node.js](../javascript/tutorial-nodejs.md) — Build a Node.js and Express web app. +- [Visual Basic](./visual-basic/tutorial-console.md) — Create a simple console app with Visual Basic. +- [F#](tutorial-fsharp-web-app.md) — Build a web app with F# and ASP.NET Core. ## Next step diff --git a/docs/ide/media/visualstudio/using-intellisense/intellisense-list-members.png b/docs/ide/media/visualstudio/using-intellisense/intellisense-list-members.png new file mode 100644 index 00000000000..819166d7786 Binary files /dev/null and b/docs/ide/media/visualstudio/using-intellisense/intellisense-list-members.png differ diff --git a/docs/ide/media/visualstudio/using-intellisense/intellisense-parameter-info.png b/docs/ide/media/visualstudio/using-intellisense/intellisense-parameter-info.png new file mode 100644 index 00000000000..946c1bb071d Binary files /dev/null and b/docs/ide/media/visualstudio/using-intellisense/intellisense-parameter-info.png differ diff --git a/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info-parameter-info.png b/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info-parameter-info.png new file mode 100644 index 00000000000..44f2c529985 Binary files /dev/null and b/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info-parameter-info.png differ diff --git a/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info.png b/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info.png new file mode 100644 index 00000000000..ab453f50565 Binary files /dev/null and b/docs/ide/media/visualstudio/using-intellisense/intellisense-quick-info.png differ diff --git a/docs/ide/using-intellisense.md b/docs/ide/using-intellisense.md index db256e6e86c..8b215a86e68 100644 --- a/docs/ide/using-intellisense.md +++ b/docs/ide/using-intellisense.md @@ -1,7 +1,7 @@ --- title: Use IntelliSense for quick information & completion description: Explore how to work with IntelliSense features in Visual Studio, including List Members, Parameter Info, Quick Info, and Complete Word. -ms.date: 1/24/2025 +ms.date: 3/19/2026 ms.topic: concept-article helpviewer_keywords: - Quick info @@ -26,74 +26,71 @@ These features include: Many aspects of IntelliSense are language-specific. For more information about IntelliSense for different languages, see the articles listed in the [Related content](#related-content) section. +In addition to IntelliSense, Visual Studio offers AI-powered code completions through GitHub Copilot. Copilot inline suggestions work alongside IntelliSense to provide whole-line and multi-line completions. To learn more, see [Get started with GitHub Copilot completions](visual-studio-github-copilot-extension.md). + ## List Members -A list of valid members from a type (or namespace) appears after you type a trigger character (for example, a period (`.`) in managed code or `::` in C++). If you continue typing characters, the list is filtered to include only the members that begin with those characters or where the beginning of *any* word within the name starts with those characters. IntelliSense also performs *camel case* matching, so you can just type the first letter of each camel-cased word in the member name to see the matches. +A list of valid members from a type or namespace appears after you type a trigger character, such as a period (`.`) in managed code or `::` in C++. If you continue typing characters, the list filters to include only the members that begin with those characters or where the beginning of *any* word within the name starts with those characters. IntelliSense also performs *camel case* matching, so you can type just the first letter of each camel-cased word in the member name to see the matches. -After selecting an item, you can insert it into your code by pressing **Tab** or by typing a space. If you select an item and type a period, the item appears followed by the period, which brings up another member list. When you select an item but before you insert it, you get [Quick Info](#quick-info) for the item. +After you select an item, you can insert it into your code by pressing **Tab** or by typing a space. If you select an item and type a period, the item appears followed by the period, which brings up another member list. When you select an item but before you insert it, you get [Quick Info](#quick-info) for the item. In the member list, the icon to the left represents the member type, such as namespace, class, function, or variable. The list might be long, so you can press **PgUp** and **PgDn** to move up or down in the list. +:::image type="content" source="media/visualstudio/using-intellisense/intellisense-list-members.png" alt-text="Screenshot of IntelliSense list members feature."::: -::: moniker range=">=vs-2022" - -:::image type="content" source="media/vs-2022/using-intellisense/intellisense-list-members.png" alt-text="Screenshot of IntelliSense list members feature."::: - -::: moniker-end +You can invoke the List Members feature manually by typing **Ctrl**+**J**, choosing **Edit** > **IntelliSense** > **List Members**, or by choosing the **List Members** button on the editor toolbar. When you invoke it on a blank line or outside a recognizable scope, the list displays symbols in the global namespace. -You can invoke the List Members feature manually by typing **Ctrl**+**J**, choosing **Edit** > **IntelliSense** > **List Members**, or by choosing the **List Members** button on the editor toolbar. When it's invoked on a blank line or outside a recognizable scope, the list displays symbols in the global namespace. +::: moniker range="visualstudio" -To turn List Members off by default so that it doesn't appear unless specifically invoked, go to **Tools** > **Options** > **Text Editor** > **All Languages** and deselect **Auto list members**. If you want to turn off List Members only for a specific language, go to the **General** settings for that language. +To turn List Members off by default so that it doesn't appear unless specifically invoked, go to **Tools** > **Options** > **Text Editor** > **All Languages** and deselect **Auto list members**. To turn off List Members only for a specific language, go to **General** settings for that language. +::: moniker-end -::: moniker range=">=vs-2022" +::: moniker range="vs-2022" -You can also change to suggestion mode, in which only the text you type is inserted into the code. For example, if you enter an identifier that isn't in the list and press **Tab**, in completion mode the entry would replace the typed identifier. To toggle between completion mode and suggestion mode, press **Ctrl**+**Alt**+**Space**, or choose **Edit** > **IntelliSense** > **Switch between automatic and tab-only IntelliSense completion**. +To turn List Members off by default so that it doesn't appear unless specifically invoked, go to **Tools** > **Options** > **Languages** > **Defaults** > **General** > **Statement Completion** and deselect **Auto list members**. To turn off List Members only for a specific language, go to **General** settings for that language. ::: moniker-end -## Parameter Info - -*Parameter Info* gives you information about the number, names, and types of parameters required by a method, attribute generic type parameter (in C#), or template (in C++). - -The parameter in bold indicates the next parameter that is required as you type the function. For overloaded functions, you can use the **Up** and **Down** arrow keys to view alternative parameter information for the function overloads. +You can also change to suggestion mode, in which only the text you type is inserted into the code. For example, if you enter an identifier that isn't in the list and press **Tab**, in completion mode the entry replaces the typed identifier. To toggle between completion mode and suggestion mode, press **Ctrl**+**Alt**+**Space**, or choose **Edit** > **IntelliSense** > **Switch between automatic and tab-only IntelliSense completion**. +## Parameter Info -::: moniker range=">=vs-2022" +*Parameter Info* shows you the number, names, and types of parameters that a method, attribute generic type parameter (in C#), or template (in C++) needs. -:::image type="content" source="media/vs-2022/using-intellisense/intellisense-parameter-info.png" alt-text="Screenshot of the IntelliSense Parameter Info feature."::: +The parameter in bold shows the next parameter you need as you type the function. For overloaded functions, use the **Up** and **Down** arrow keys to see other parameter information for the function overloads. -::: moniker-end +:::image type="content" source="media/visualstudio/using-intellisense/intellisense-parameter-info.png" alt-text="Screenshot of the IntelliSense Parameter Info feature."::: -When you annotate functions and parameters with XML Documentation comments, the comments display as Parameter Info. For more information, see [Supply XML code comments](reference/generate-xml-documentation-comments.md). +When you add XML Documentation comments to functions and parameters, Parameter Info shows those comments. For more information, see [Supply XML code comments](reference/generate-xml-documentation-comments.md). -You can manually invoke Parameter Info by choosing **Edit** > **IntelliSense** > **Parameter Info**, by pressing **Ctrl**+**Shift**+**Space**, or by choosing the **Parameter Info** button on the editor toolbar. +You can manually open Parameter Info by choosing **Edit** > **IntelliSense** > **Parameter Info**, by pressing **Ctrl**+**Shift**+**Space**, or by choosing the **Parameter Info** button on the editor toolbar. ## Quick Info *Quick Info* displays the complete declaration for any identifier in your code. +:::image type="content" source="media/visualstudio/using-intellisense/intellisense-quick-info.png" alt-text="Screenshot of the IntelliSense Quick Info feature."::: -::: moniker range=">=vs-2022" - -:::image type="content" source="media/vs-2022/using-intellisense/intellisense-quick-info.png" alt-text="Screenshot of the IntelliSense Quick Info feature."::: +When you select a member from the List Members box, Quick Info also appears. -::: moniker-end +:::image type="content" source="media/visualstudio/using-intellisense/intellisense-quick-info-parameter-info.png" alt-text="Screenshot of the IntelliSense Quick Info and Parameter Info feature."::: -When you select a member from the List Members box, Quick Info also appears. +You can manually invoke Quick Info by choosing **Edit** > **IntelliSense** > **Quick Info**, by pressing **Ctrl**+**K**, **Ctrl**+**I**, or by choosing the **Quick Info** button on the editor toolbar. +If a function is overloaded, IntelliSense might not display information for all forms of the overload. -::: moniker range=">=vs-2022" +::: moniker range="visualstudio" -:::image type="content" source="media/vs-2022/using-intellisense/intellisense-quick-info-parameter-info.png" alt-text="Screenshot of the IntelliSense Quick Info and Parameter Info feature."::: +To turn Quick Info off, go to **Tools** > **Options** > **Text Editor** > **All Languages** and deselect **Show Quick Info on hover** in the **Settings** section. ::: moniker-end -You can manually invoke Quick Info by choosing **Edit** > **IntelliSense** > **Quick Info**, by pressing **Ctrl**+**K**, **Ctrl**+**I**, or by choosing the **Quick Info** button on the editor toolbar. +::: moniker range="vs-2022" -If a function is overloaded, IntelliSense might not display information for all forms of the overload. +To turn Quick Info off, go to **Tools** > **Options** > **Languages** and deselect **Show Quick Info on hover** in the **General** section. -You can turn Quick Info off for C++ code by navigating to **Tools** > **Options** > **Text Editor** > **C/C++** > **Advanced**, and setting **Auto Quick Info** to `false`. +::: moniker-end ## Complete Word @@ -101,20 +98,32 @@ You can turn Quick Info off for C++ code by navigating to **Tools** > **Options* ## IntelliSense options -IntelliSense options are on by default. To turn them off, go to **Tools** > **Options** > **Text Editor** > **All Languages** and deselect **Parameter information** or **Auto list members** if you don't want the List Members feature. +IntelliSense options are on by default. + +::: moniker range="visualstudio" + +To turn them off, go to **Tools** > **Options** > **Languages** > **Defaults** > **General** > **Statement Completion** and deselect **Parameter information** or **Auto list members**. + +::: moniker-end + +::: moniker range="vs-2022" + +To turn them off, go to **Tools** > **Options** > **Text Editor** > **All Languages** and deselect **Parameter information** or **Auto list members**. + +::: moniker-end > [!TIP] -> If you want to change the appearance of user interface elements in Visual Studio, go to **Tools** > **Options** > **Environment** > **Fonts and Colors**. For more information about these settings and how to interact with them, see [Fonts and Colors, Environment, Options dialog box](reference/fonts-and-colors-environment-options-dialog-box.md). +> To change the appearance of user interface elements in Visual Studio, go to **Tools** > **Options** > **Environment** > **Fonts and Colors**. For more information about these settings and how to interact with them, see [Fonts and Colors, Environment, Options dialog box](fonts-and-colors-environment-options-dialog-box.md). ## IntelliSense icons -The icons in IntelliSense can convey additional meaning with icon modifiers. These are stars, hearts, and locks layered on top of the object's icon that convey protected, internal, or private, respectively. +The icons in IntelliSense convey additional meaning through icon modifiers. These icons include stars, hearts, and locks layered on top of the object's icon that convey protected, internal, or private, respectively. :::moniker range="visualstudio" | Icon | Accessibility | Description | |------------|---------------------|-------------------| -| ![Public Icon Modifier](../ide/media/visualstudio/intellisense-public-no-modifier.png) | Public class | Access is not restricted. | +| ![Public Icon Modifier](../ide/media/visualstudio/intellisense-public-no-modifier.png) | Public class | Access isn't restricted. | | ![Protected Icon Modifier](../ide/media/visualstudio/intellisense-protected-modifier.png) | Protected class | Access is limited to the containing class or types derived from the containing class. | | ![Protected Internal Icon Modifier](../ide/media/visualstudio/intellisense-protected-modifier.png) | Protected internal class | Access is limited to the current assembly or types derived from the containing class. | | ![Internal Icon Modifier](../ide/media/visualstudio/intellisense-internal-modifier.png) | Internal class | Access is limited to the current assembly. | @@ -126,7 +135,7 @@ The icons in IntelliSense can convey additional meaning with icon modifiers. The | Icon | Accessibility | Description | |------------|---------------------|-------------------| -| ![Public Icon Modifier](../ide/media/intellisensePublicNoModifier.png) | Public class | Access is not restricted. | +| ![Public Icon Modifier](../ide/media/intellisensePublicNoModifier.png) | Public class | Access isn't restricted. | | ![Protected Icon Modifier](../ide/media/intellisenseProtectedModifier.png) | Protected class | Access is limited to the containing class or types derived from the containing class. | | ![Protected Internal Icon Modifier](../ide/media/intellisenseProtectedInternalModifier.png) | Protected internal class | Access is limited to the current assembly or types derived from the containing class. | | ![Internal Icon Modifier](../ide/media/intellisenseInternalModifier.png) | Internal class | Access is limited to the current assembly. | @@ -152,6 +161,7 @@ The IntelliSense options might not work as you expect in certain cases. ## Related content +- [Get started with GitHub Copilot](visual-studio-github-copilot-get-started.md) - [C# IntelliSense](../ide/visual-csharp-intellisense.md) - [Visual Basic IntelliSense](../ide/visual-basic-specific-intellisense.md) - [JavaScript IntelliSense](../ide/javascript-intellisense.md) diff --git a/docs/install/create-an-offline-installation-of-visual-studio.md b/docs/install/create-an-offline-installation-of-visual-studio.md index 5791358d627..af1f734b016 100644 --- a/docs/install/create-an-offline-installation-of-visual-studio.md +++ b/docs/install/create-an-offline-installation-of-visual-studio.md @@ -1,7 +1,7 @@ --- title: Create an offline installation description: Create an offline installation package to install Visual Studio offline when you have an unreliable internet connection or low bandwidth. -ms.date: 10/28/2024 +ms.date: 3/19/2026 ms.topic: how-to f1_keywords: - offline installation [Visual Studio] @@ -17,25 +17,25 @@ ms.subservice: installation > 📣 **We'd love to hear your feedback!** > *Please take a moment to complete this [survey](https://aka.ms/learnlayoutfeedback) and let us know how we can improve the layout experience. Thank you for your support!* -Visual Studio is designed to work well in various computer configurations. In this article, you learn how to create an offline installation package of files for installation on the **local machine**. +Visual Studio works well in various computer configurations. In this article, you learn how to create an offline installation package of files for installation on the **local machine**. > [!IMPORTANT] -> If you are an enterprise IT administrator who wants to perform a deployment of Visual Studio throughout a network of client workstations, or if you need to create an installation package of files to transfer to or install onto *another* machine, refer to our [Visual Studio Administrators Guide](https://aka.ms/vs/admin/guide), the [create a network-based installation of Visual Studio](create-a-network-installation-of-visual-studio.md) page, and the [deploy a layout onto a client machine](deploy-a-layout-onto-a-client-machine.md) documentation. +> If you're an enterprise IT administrator who wants to perform a deployment of Visual Studio throughout a network of client workstations, or if you need to create an installation package of files to transfer to or install onto *another* machine, see the [Visual Studio Administrators Guide](https://aka.ms/vs/admin/guide), the [create a network-based installation of Visual Studio](create-a-network-installation-of-visual-studio.md) page, and the [deploy a layout onto a client machine](deploy-a-layout-onto-a-client-machine.md) documentation. ## Use the "Download all, then install" feature Sometimes online access is problematic. For example, you might have an unreliable internet connection or your internet connection might have low bandwidth. For situations like these, you have other methods available for acquiring Visual Studio. You can use the **Download all, then install** feature from the Visual Studio Installer to download an installation package on the local machine *before* you install it locally, or you can use the command line to create a local installation package to install locally later. -After you [download the bootstrapper](#step-1---download-the-visual-studio-bootstrapper), run it to install Visual Studio. It'll first install and then launch the latest version of the Visual Studio Installer, which you can use to customize and configure your installation, download installation packages, and install the product. +After you [download the bootstrapper](#step-1---download-the-visual-studio-bootstrapper), run it to install Visual Studio. It first installs and then launches the latest version of the Visual Studio Installer. You can use the installer to customize and configure your installation, download installation packages, and install the product. To complete downloading the product before installation starts, select the **Download all, then install** option in the dropdown at the bottom of the default **Workloads** tab of the Visual Studio Installer. The purpose of this feature is to download the Visual Studio packages in advance on the computer where Visual Studio will eventually be installed. By downloading the packages locally first, you can then safely disconnect from the internet before you install Visual Studio. - ![The "Download all, then install" option](media/vs-2019/download-all-then-install-from-installer.png) + ![The "Download all, then install" option](media/visualstudio/download-all-then-install-from-installer.png) > [!NOTE] > The **Download all, then install** functionality downloads a Visual Studio installation package that is customized to the local machine. Don't transfer this downloaded installation package to another computer, as it's not designed to work that way. > -> If you want to download an installation package, host it on a network share or an intranet website, and transfer it to or install it on another machine, then you'll need to create a network layout as described in the [create a network-based installation of Visual Studio](create-a-network-installation-of-visual-studio.md) documentation. +> If you want to download an installation package, host it on a network share or an intranet website, and transfer it to or install it on another machine, you need to create a network layout as described in the [create a network-based installation of Visual Studio](create-a-network-installation-of-visual-studio.md) documentation. You can also configure future updates of Visual Studio to respect the **Download all, then install** behavior. For more information, see the [installation and download behavior](/visualstudio/install/update-visual-studio?#installation-and-download-behaviors-1) documentation. @@ -47,23 +47,29 @@ You can also configure future updates of Visual Studio to respect the **Download ### Step 2 - Create a local layout -Open a command prompt with administrator privileges, navigate to the directory where you downloaded the bootstrapper, and use the [bootstrapper's parameters](use-command-line-parameters-to-install-visual-studio.md#layout-command-and-command-line-parameters) to create your local layout. You must have an internet connection to complete this step. +Open a command prompt with administrator privileges, go to the directory where you downloaded the bootstrapper, and use the [bootstrapper's parameters](use-command-line-parameters-to-install-visual-studio.md#layout-command-and-command-line-parameters) to create your local layout. You need an internet connection to finish this step. -You can install a language other than English by changing `en-US` to a locale from the [list of language locales](use-command-line-parameters-to-install-visual-studio.md#list-of-language-locales), and you can use the [list of components and workloads](workload-and-component-ids.md) to further customize your local layout. +To install a language other than English, change `en-US` to a locale from the [list of language locales](use-command-line-parameters-to-install-visual-studio.md#list-of-language-locales). To further customize your local layout, use the [list of components and workloads](workload-and-component-ids.md). -Here are some common local layout creation examples. More examples can be found on the [create a network layout of Visual Studio](create-a-network-installation-of-visual-studio.md#configure-the-contents-of-a-layout) page and on the [command-line parameter examples](command-line-parameter-examples.md#using---layout-to-create-a-network-layout-or-a-local-cache) page. +The following examples show how to create a local layout. For more examples, see [create a network layout of Visual Studio](create-a-network-installation-of-visual-studio.md#configure-the-contents-of-a-layout) and [command-line parameter examples](command-line-parameter-examples.md#using---layout-to-create-a-network-layout-or-a-local-cache). -- To create a complete local layout with all features and all languages (this'll take a long time—we have *lots* of features!), run: +- To create a complete local layout with all features and all languages (this operation takes a long time because there are many features), run: ```shell vs_enterprise.exe --layout c:\localVSlayout ``` +::: moniker range="visualstudio" -::: moniker range=">=vs-2022" + > [!NOTE] + > Make sure that your full installation path is less than 80 characters and that your machine has ample storage. A complete local layout of Visual Studio requires at least 45 GB of disk space. For more information, see [System requirements](/visualstudio/releases/2026/vs-system-requirements/). + +::: moniker-end + +::: moniker range="vs-2022" > [!NOTE] - > Make sure that your full installation path is less than 80 characters and that your machine has ample storage. A complete local layout of Visual Studio requires a minimum of 45 GB of disk space. For more information, see [System requirements](/visualstudio/releases/2022/system-requirements/). + > Make sure that your full installation path is less than 80 characters and that your machine has ample storage. A complete local layout of Visual Studio requires at least 45 GB of disk space. For more information, see [System requirements](/visualstudio/releases/2022/system-requirements/). ::: moniker-end @@ -73,7 +79,7 @@ Here are some common local layout creation examples. More examples can be found vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --lang en-US ``` -- For C++ desktop development including all recommended and optional components, for only one language run: +- For C++ desktop development including all recommended and optional components, for only one language, run: ```shell vs_enterprise.exe --layout c:\localVSlayout --add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --includeOptional --lang en-US @@ -83,9 +89,9 @@ Here are some common local layout creation examples. More examples can be found ### Step 3 - Install Visual Studio from the local layout -When you install Visual Studio from a local layout, the Visual Studio Installer uses the local versions of the files. But if you select components during installation that aren't in the layout, then the Visual Studio Installer attempts to download them from the internet. To make sure you install only the files you previously downloaded, use the same [command-line options](use-command-line-parameters-to-install-visual-studio.md) you used to create the local layout. To make sure your installer doesn't try to access the internet when it's installing the product, use the `--noweb` switch. +When you install Visual Studio from a local layout, the Visual Studio Installer uses the local versions of the files. But if you select components during installation that aren't in the layout, the Visual Studio Installer tries to download them from the internet. To make sure you install only the files you previously downloaded, use the same [command-line options](use-command-line-parameters-to-install-visual-studio.md) you used to create the local layout. To make sure your installer doesn't try to access the internet when it's installing the product, use the `--noweb` switch. -For example, if you created a local installation layout with the following command: +For example, if you created a local installation layout by using the following command: ::: moniker range=">=vs-2022" @@ -103,7 +109,7 @@ c:\localVSlayout\vs_enterprise.exe --noWeb --add Microsoft.VisualStudio.Workload ::: moniker-end > [!IMPORTANT] -> If you're using Visual Studio Community, you might be prompted to sign in within 30 days of installation, but it won't impact your ability to use the product. +> If you're using Visual Studio Community, you might be prompted to sign in within 30 days of installation, but this prompt doesn't affect your ability to use the product. > [!NOTE] > If you get an error that a signature is invalid, you must [install updated certificates](install-certificates-for-visual-studio-offline.md). Open the Certificates folder in your local layout. Double-click each of the certificate files, and then click through the Certificate Manager wizard. If you're asked for a password, leave it blank. diff --git a/docs/install/media/visualstudio/download-all-then-install-from-installer.png b/docs/install/media/visualstudio/download-all-then-install-from-installer.png new file mode 100644 index 00000000000..7d5a0264645 Binary files /dev/null and b/docs/install/media/visualstudio/download-all-then-install-from-installer.png differ