Merging changes synced from https://github.com/MicrosoftDocs/visualstudio-docs-pr (branch live)

Author: Learn Build Service GitHub App

docs/azure/includes/cloud-services-legacy.md

@@ -0,0 +1,11 @@
+---
+title: "include"
+description: "include"
+author: ghogen
+ms.technology: vs-azure
+ms.author: ghogen
+ms.topic: "include"
+ms.date: 10/25/2021
+---
+> [!NOTE]
+> This article applies to Azure Cloud Services (classic), which is now deprecated for new customers and will be retired on August 31, 2024. Existing services built with this technology are still supported through [Azure Cloud Services (extended support)](../cloud-services-extended-support.md). For new development, we recommend that you use a newer service type designed for your specific purpose, such as [Azure App Service](/azure/app-service/overview), [Azure Functions](/azure/azure-functions/functions-overview?pivots=programming-language-csharp), or [Azure Container Apps](/azure/container-apps/overview). For the latest list of available services, see [Directory of Azure products](https://azure.microsoft.com/products/).

docs/azure/vs-azure-tools-azure-project-create.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 Visual Studio provides a project template that lets you create an [Azure cloud service](/azure/cloud-services/cloud-services-choose-me), which is a simple general-purpose Azure service. Once the project has been created, Visual Studio enables you to configure, debug, and deploy the cloud service to Azure.
 
 ## Steps to create an Azure cloud service project in Visual Studio

docs/azure/vs-azure-tools-cloud-service-project-managing-roles.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Managing roles in Azure cloud services with Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 After you have created your Azure cloud service, you can add new roles to it or remove existing roles from it. You can also import an existing project and convert it to a role. For example, you can import an ASP.NET web application and designate it as a web role.
 
 ## Adding a role to an Azure cloud service

docs/azure/vs-azure-tools-cloud-service-publish-set-up-required-services-in-visual-studio.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 To publish a cloud service project, you must set up the following services as described in this article:
 
 * A **cloud service** to run your roles in the Azure environment, and

docs/azure/vs-azure-tools-cloud-service-retain-a-constant-virtual-ip-address.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Retain a constant virtual IP address for an Azure cloud service
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 When you update a cloud service that's hosted in Azure, you might need to ensure that the virtual IP address (VIP) of the service doesn't change. Many domain management services use the Domain Name System (DNS) for registering domain names. DNS works only if the VIP remains the same. You can use the **Publish Wizard** in Azure Tools to ensure that the VIP of your cloud service doesn’t change when you update it. For more information about how to use DNS domain management for cloud services, see [Configuring a custom domain name for an Azure cloud service](/azure/cloud-services/cloud-services-custom-domain-name-portal).
 
 ## Publish a cloud service without changing its VIP

docs/azure/vs-azure-tools-command-line-build.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Building Azure projects from the command line
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 Using the Microsoft Build Engine (MSBuild), you can build products in build-lab environments where Visual Studio is not installed. MSBuild uses an XML format for project files that's extensible and fully supported by Microsoft. Using the MSBuild file format, you can describe what items must be built for one or more platforms and configurations.
 
 You can also run MSBuild at the command line, and this topic describes that approach. By setting properties on the command line, you can build specific configurations of a project. Similarly, you can also define the targets that MSBuild builds. For more information about command-line parameters and MSBuild, see [MSBuild Command-Line Reference](../msbuild/msbuild-command-line-reference.md).

docs/azure/vs-azure-tools-configure-roles-for-cloud-service.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Configure Azure cloud service roles with Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 An Azure cloud service can have one or more worker or web roles. For each role, you need to define how that role is set up and also configure how that role runs.
 
 The information for your cloud service is stored in the following files:

docs/azure/vs-azure-tools-configuring-an-azure-project.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Configure an Azure cloud service project with Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 You can configure an Azure cloud service project, depending on your requirements for that project. You can set properties for the project for the following categories:
 
 - **Publish a cloud service to Azure** - You can set a property to make sure that an existing cloud service deployed to Azure is not accidentally deleted.

docs/azure/vs-azure-tools-debugging-cloud-services-overview.md

@@ -11,6 +11,9 @@ ms.technology: vs-ide-debug
 # Learn the various ways to debug an Azure cloud service
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 This article provides links to the various ways to debug an Azure cloud service.
 
 ## Debugging an Azure cloud service in Visual Studio

docs/azure/vs-azure-tools-diagnostics-for-cloud-services-and-virtual-machines.md

@@ -11,6 +11,9 @@ ms.author: mikejo
 # Set up diagnostics for Azure Cloud Services and virtual machines
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 When you need to troubleshoot an Azure cloud service or virtual machine, you can use Visual Studio to more easily set up Azure Diagnostics. Diagnostics captures system data and logging data on the virtual machines and virtual machine instances that run your cloud service. Diagnostics data is transferred to a storage account that you choose. For more information about diagnostics logging in Azure, see [Enable diagnostics logging for Web Apps in Azure App Service](/azure/app-service/web-sites-enable-diagnostic-log).
 
 In this article, we show you how to use Visual Studio to turn on and set up Azure Diagnostics, both before and after deployment. Learn how to set up Diagnostics on Azure virtual machines, how to select the types of diagnostics information to collect, and how to view the information after it's collected.

docs/azure/vs-azure-tools-emulator-express-debug-run.md

@@ -11,6 +11,9 @@ ms.author: mikejo
 # Using Emulator Express to run and debug an Azure cloud service on a local machine
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 By using Emulator Express, you can test and debug a cloud service without running Visual Studio as an administrator. You can set your project settings to use either Emulator Express or the full emulator, depending on the requirements of your cloud service. For more information about the full emulator, see [Run an Azure Application in the Compute Emulator](/azure/storage/common/storage-use-emulator).
 
 ## Using Emulator Express in Visual Studio

docs/azure/vs-azure-tools-intellitrace-debug-published-cloud-services.md

@@ -11,6 +11,9 @@ ms.author: mikejo
 # Debugging a published Azure cloud service with Visual Studio and IntelliTrace
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 With IntelliTrace, you can log extensive debugging information for a role instance when it runs in Azure. If you need to find the cause of a problem, you can use the IntelliTrace logs to step through your code from Visual Studio as if it were running in Azure. In effect, IntelliTrace records key code execution and environment data when your Azure application is running as a cloud service in Azure, and lets you replay the recorded data from Visual Studio.
 
 You can use IntelliTrace if you have Visual Studio Enterprise installed and your Azure application targets .NET Framework 4 or a later version. IntelliTrace collects information for your Azure roles. The virtual machines for these roles always run 64-bit operating systems.

docs/azure/vs-azure-tools-migrate-publish-web-app-to-cloud-service.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 To take advantage of the hosting services and scaling ability of Azure, you might want to migrate and deploy your web application to an Azure cloud service. Only minimal changes are required. This article covers deploying to cloud services only; for App Service, see [Deploy a web app in Azure App Service](/azure/app-service/app-service-deploy-local-git).
 
 > [!Important]

docs/azure/vs-azure-tools-multiple-services-project-configurations.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 An Azure cloud service project in Visual Studio includes three configuration files: `ServiceDefinition.csdef`, `ServiceConfiguration.Local.cscfg`, and `ServiceConfiguration.Cloud.cscfg`:
 
 - `ServiceDefinition.csdef` is deployed to Azure to describe the requirements of the cloud service and its roles, and to provide settings that apply to all instances. Settings can be read at run time using the Azure Service Hosting Runtime API. This file can be updated on Azure only when the cloud service is stopped.

docs/azure/vs-azure-tools-optimizing-azure-code-in-visual-studio.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Optimizing Your Azure Code
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 When you’re programming apps that use Microsoft Azure, there are some coding practices you should follow to help avoid problems with app scalability, behavior and performance in a cloud environment. Microsoft provides an Azure Code Analysis tool that recognizes and identifies several of these commonly-encountered issues and helps you resolve them. You can download the tool in Visual Studio via NuGet.
 
 ## Azure Code Analysis rules

docs/azure/vs-azure-tools-performance-profiling-cloud-services.md

@@ -11,6 +11,9 @@ ms.author: mikejo
 # Testing the performance of a cloud service
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Overview
 You can test the performance of a cloud service in the following ways:
 

docs/azure/vs-azure-tools-publish-azure-application-wizard.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 After you develop a web application in Visual Studio, you can publish that application to an Azure cloud service by using the **Publish Azure Application** wizard.
 
 ## Accessing the Publish Azure Application wizard

docs/azure/vs-azure-tools-publish-webapplicationwebsite-windows-powershell-script.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # Publish-WebApplicationWebSite (Windows PowerShell script)
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Syntax
 Publishes a web project to an Azure website. The script creates the required resources in your Azure subscription if they don't exist.
 

docs/azure/vs-azure-tools-publishing-a-cloud-service.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 Visual Studio can publish an application directly to Azure, with support for both Staging and Production environments of a cloud service. When publishing, you select the deployment environment and a storage account that's used temporarily for the deployment package.
 
 When you're developing and testing an Azure application, you can use Web Deploy to publish changes incrementally for your web roles. After you publish your application to a deployment environment, Web Deploy lets you deploy changes directly to the virtual machine that is running the web role. You do not have to package and publish your entire Azure application each time you want to update your web role to test out the changes. With this approach, you can have your web role changes available in the cloud for testing without waiting to have your application published to a deployment environment.

docs/azure/vs-azure-tools-resources-managing-with-cloud-explorer.md

@@ -13,6 +13,8 @@ monikerRange: "<=vs-2019"
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 > [!Important]
 > Cloud Explorer has been retired in Visual Studio 2022. Instead, you can use the following alternatives:
 > - To debug Azure App Services or Azure Function apps, you can use the Connected Services or the Publish features available on all projects. 

docs/azure/vs-azure-tools-service-configurations-and-profiles-how-to-manage.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # How to manage service configurations and profiles
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Overview
 When you publish a cloud service, Visual Studio stores configuration information in two kinds of configuration files: service configurations and profiles. Service configurations (.cscfg files) store settings for the deployment environments for an Azure cloud service. Azure uses these configuration files when it manages your cloud services. On the other hand, profiles (.azurePubxml files) store publish settings for cloud services. These settings are a record of what you choose when you use the publish wizard, and are used locally by Visual Studio. This topic explains how to work with both types of configuration files.
 

docs/azure/vs-azure-tools-setting-up-named-authentication-credentials.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 To publish an application to Azure or to monitor an existing cloud service, Visual Studio requires credentials to authenticate requests to Azure, namely your Azure subscription ID and a valid X.509 v3 certificate with a key of at least 2048 bits. You provide these credentials through either of the following methods:
 
 - In Visual Studio select **View > Server Explorer**, right-click the **Azure** node, select **Connect to Microsoft Azure Subscription**, and sign in.

docs/azure/vs-azure-tools-storage-resources-server-explorer-browse-manage.md

@@ -15,6 +15,8 @@ monikerRange: "<=vs-2019"
 
 [!INCLUDE [storage-try-azure-tools](./includes/storage-try-azure-tools.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Overview
 
 If you've installed Azure workload for Microsoft Visual Studio 2019, you can view blob, queue, and table data from your storage accounts for Azure. The Azure **Storage** node in Server Explorer shows data that’s in your local storage emulator account and your other Azure storage accounts.

docs/azure/vs-azure-tools-table-designer-construct-filter-strings.md

@@ -12,6 +12,8 @@ ms.author: ghogen
 
  [!INCLUDE [Visual Studio](../includes/applies-to-version/vs-windows-only.md)]
 
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Overview
 
 To filter data in an Azure table that is displayed in the Visual Studio **Table Designer**, you construct a filter string and enter it into the filter field. The filter string syntax is defined by the WCF Data Services and is similar to a SQL WHERE clause, but is sent to the Table service via an HTTP request. The **Table Designer** handles the proper encoding for you, so to filter on a desired property value, you need only enter the property name, comparison operator, criteria value, and optionally, Boolean operator in the filter field. You do not need to include the $filter query option as you would if you were constructing a URL to query the table via the [Storage Services REST API Reference](/rest/api/storageservices/).

docs/azure/vs-azure-tools-upgrade-projects-to-the-current-version-of-the-azure-tools.md

@@ -11,6 +11,9 @@ ms.author: ghogen
 # How to upgrade projects to the current version of the Azure Tools for Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
+
+ [!INCLUDE [Cloud Services](./includes/cloud-services-legacy.md)]
+
 ## Overview
 After you install the current release of the Azure Tools (or a previous release that's newer than 1.6), any projects that were created by using a Azure Tools release before 1.6 (November 2011) will be automatically upgraded as soon as you open them. If you created projects by using the 1.6 (November 2011) release of those tools and you still have that release installed, you can open those projects in the older release and decide later whether to upgrade them.
 

docs/data-tools/add-code-to-datasets-in-n-tier-applications.md

@@ -1,5 +1,5 @@
 ---
-title: Add code to DataSets in n-tier applications
+title: Add code to ADO.NET DataSets in n-tier .NET Framework applications
 description: Add code to ADO.NET datasets in n-tier apps in Visual Studio. Create a partial class file for a dataset and add code to it (instead of to DatasetName.Dataset.Designer).
 ms.date: 11/04/2016
 ms.topic: how-to
@@ -13,7 +13,7 @@ ms.author: ghogen
 manager: jmartens
 ms.technology: vs-data-tools
 ---
-# Add code to DataSets in n-tier applications
+# Add code to DataSets in n-tier .NET Framework applications
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 

docs/data-tools/add-code-to-tableadapters-in-n-tier-applications.md

@@ -1,5 +1,5 @@
 ---
-title: Add code to TableAdapters in n-tier applications
+title: Add code to ADO.NET TableAdapters in n-tier .NET Framework applications
 description: Add code to ADO.NET table adapters in n-tier applications. Create a partial class file for TableAdapter and add code to it (instead of to DatasetName.DataSet.Designer).
 ms.date: 11/04/2016
 ms.topic: how-to
@@ -14,7 +14,7 @@ ms.author: ghogen
 manager: jmartens
 ms.technology: vs-data-tools
 ---
-# Add code to TableAdapters in n-tier applications
+# Add code to TableAdapters in n-tier .NET Framework applications
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 

docs/data-tools/add-custom-controls-to-the-data-sources-window.md

@@ -1,5 +1,5 @@
 ---
-title: Add custom controls to the Data Sources window
+title: Add custom controls to the Data Sources window for .NET Framework applications
 description: Add custom controls to the Data Sources window with ADO.NET in Visual Studio. Customize the bindable controls list. Add associated controls.
 ms.date: 11/04/2016
 ms.topic: how-to
@@ -17,7 +17,7 @@ ms.author: ghogen
 manager: jmartens
 ms.technology: vs-data-tools
 ---
-# Add custom controls to the Data Sources window
+# Add custom controls to the Data Sources window for .NET Framework applications
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 

docs/data-tools/add-new-connections.md

@@ -1,5 +1,5 @@
 ---
-title: Connect to a database or open an MDF file
+title: Connect to a database or open an MDF file in Visual Studio
 description: Connect to a database or data service with ADO.NET in Visual Studio, or connect to a database opened from an MDF file in Visual Studio.
 ms.date: 03/07/2023
 ms.topic: how-to
@@ -8,7 +8,7 @@ ms.author: ghogen
 manager: jmartens
 ms.technology: vs-data-tools
 ---
-# Connect to a database
+# Connect to a database in Visual Studio
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
 

docs/data-tools/add-new-data-sources.md

@@ -1,5 +1,5 @@
 ---
-title: Add new data sources
+title: Add new data sources in ADO.NET applications (.NET Framework)
 description: Add new ADO.NET data sources in Visual Studio. A data source is a .NET Framework object that connects to a data store and make the data available to a .NET Framework application.
 ms.date: 06/01/2023
 ms.topic: how-to
@@ -13,7 +13,7 @@ ms.author: ghogen
 manager: jmartens
 ms.technology: vs-data-tools
 ---
-# Add new data sources
+# Add new data sources in ADO.NET applications (.NET Framework)
 
  [!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]