Skip to content

Repo sync for protected branch #9718

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Oct 18, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -990,6 +990,11 @@
"redirect_url": "/visualstudio/ide/how-to-configure-projects-to-target-platforms",
"redirect_document_id": false
},
{
"source_path": "docs/debugger/error-mixed-mode-debugging-for-ia64-processes-is-unsupported.md",
"redirect_url": "/visualstudio/debugger/mixed-mode-debugging-for-ia64-processes-is-unsupported",
"redirect_document_id": false
},
{
"source_path": "docs/debugger/how-to-use-edit-and-continue-csharp.md",
"redirect_url": "/visualstudio/debugger/edit-and-continue-visual-csharp",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/azure/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,8 @@ Data providers are making services available via standard protocols, such as ODa

ASP.NET Core provides a comprehensive solution for simple web sites and complex web applications. Azure services can help address many of the needs and solve many of the challenges that arise in web site and web application development. ASP.NET Core web applications frequently use client-side JavaScript.

:::image type="content" source="./media/overview-azure-integration/scalable-ecommerce-web-app.png" alt-text="Diagram of web application example architecture." lightbox="./media/overview-azure-integration/scalable-ecommerce-web-app-high-res.png" :::

### Connect to Azure Cache for Redis

Azure Cache for Redis provides an in-memory data store for Azure services, web sites, and web applications. You can use Azure Cache for Redis as a distributed data or content cache, a session store, a message broker, and more. Supported scenarios include:
Expand Down

This file was deleted.

21 changes: 21 additions & 0 deletions docs/debugger/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,27 @@ landingContent:
- text: Set a watch on variables
url: watch-and-quickwatch-windows.md

- title: Measure performance
linkLists:
- linkListType: tutorial
links:
- text: Get started analyzing CPU usage
url: ../profiling/beginners-guide-to-performance-profiling.md
- text: Get started measuring memory usage
url: ../profiling/memory-usage.md
- linkListType: overview
links:
- text: First look at profiling tools
url: ../profiling/profiling-feature-tour.md
- text: Which tool should I use?
url: ../profiling/choose-performance-tool.md
- text: Ways to run profiling tools
url: ../profiling/running-profiling-tools-with-or-without-the-debugger.md
- linkListType: concept
links:
- text: Understanding performance collection methods
url: ../profiling/understanding-performance-collection-methods-perf-profiler.md

# Card
- title: Collaborate
linkLists:
Expand Down
4 changes: 2 additions & 2 deletions docs/debugger/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -311,7 +311,7 @@
- name: Mixed mode debugging is supported only when using Microsoft .NET Framework 2.0 or greater
href: error-mixed-mode-debugging-is-supported-only-when-using-microsoft-dotnet-framework-2-0-or-greater.md
- name: Mixed mode debugging for IA64 processes is unsupported
href: error-mixed-mode-debugging-for-ia64-processes-is-unsupported.md
href: mixed-mode-debugging-for-ia64-processes-is-unsupported.md
- name: Mixed-mode debugging for x64 processes is supported only when using Microsoft .NET Framework 4 or greater
href: error-mixed-mode-debugging-for-x64-processes-is-supported-only-when-using-microsoft-dotnet-framework-4-or-greater.md
- name: Remote machine does not appear in a Remote Connections dialog
Expand Down Expand Up @@ -704,7 +704,7 @@
href: source-server-security-alert.md
- name: Mixed mode debugging for x64 processes is only supported when using Microsoft.NET Framework 4 or greater
href: mixed-mode-debugging-for-x64-processes-is-only-supported-when-using-microsoft-dotnet-framework-4-or-greater.md
- name: Mixed mode debugging for IA64 processes is unsupported.
- name: Mixed mode debugging for IA64 processes is unsupported
href: mixed-mode-debugging-for-ia64-processes-is-unsupported.md
- name: Mixed Mode Debugging Is Only Supported when Using Microsoft .NET Framework 2.0 or 3.0
href: mixed-mode-debugging-is-only-supported-when-using-microsoft-dotnet-framework-2-0-or-3-0.md
Expand Down
15 changes: 15 additions & 0 deletions docs/deployment/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,21 @@ landingContent:
url: ../azure/azure-deployment-using-github-actions.md
- text: Deploy Entity Framework Core app with GitHub Actions
url: ../azure/end-to-end-deployment-entity-framework-core-github-actions.md

# Card
- title: Deploy Docker containers
linkLists:
- linkListType: how-to-guide
links:
- text: Deploy to Azure Container Registry
url: ../containers/hosting-web-apps-in-docker.md
- text: Deploy to Azure App Service
url: ../containers/deploy-app-service.md
- text: Deploy to Docker Hub
url: ../containers/deploy-docker-hub.md
- text: Deploy without a Dockerfile
url: ../containers/deploy-containerized.md

# Card
- title: Additional deployment types
linkLists:
Expand Down
2 changes: 1 addition & 1 deletion docs/ide/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ landingContent:
- text: Publish a web site
url: ../deployment/quickstart-deploy-to-a-web-site.md
- text: Access data
url: ../data-tools/create-a-simple-data-application-by-using-adonet.md
url: ../data-tools/accessing-data-in-visual-studio.md
- text: Personalize the IDE
url: ../ide/quickstart-personalize-the-ide.md
- text: Productivity features
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
56 changes: 30 additions & 26 deletions docs/javascript/tutorial-asp-net-core-with-angular.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Create an ASP.NET Core app with Angular"
description: In this tutorial, you create an app using ASP.NET Core and Angular
ms.date: 04/25/2023
ms.date: 10/16/2023
ms.topic: tutorial
ms.devlang: javascript
author: mikejo5000
Expand All @@ -18,7 +18,7 @@ monikerRange: '>= vs-2022'

In this article, you learn how to build an ASP.NET Core project to act as an API backend and an Angular project to act as the UI.

Currently, Visual Studio includes ASP.NET Core Single Page Application (SPA) templates that support Angular and React. The templates provide a built-in Client App folder in your ASP.NET Core projects that contains the base files and folders of each framework.
Visual Studio includes ASP.NET Core Single Page Application (SPA) templates that support Angular and React. The templates provide a built-in Client App folder in your ASP.NET Core projects that contains the base files and folders of each framework.

You can use the method described in this article to create ASP.NET Core Single Page Applications that:

Expand All @@ -43,13 +43,13 @@ Make sure to install the following:

1. Search for Angular in the search bar at the top and then select **Angular and ASP.NET Core (Preview)**.

:::image type="content" source="media/vs-2022/angular-choose-template.png" alt-text="Screenshot showing choosing a template":::
:::image type="content" source="media/vs-2022/angular-choose-template.png" alt-text="Screenshot showing choosing a template.":::

1. Give your project and solution a name, and choose **Create**.
1. Name the project **AngularWithASP** and then choose **Create**.

Once the project is created, Solution Explorer should look like this:
Solution Explorer shows the following::

:::image type="content" source="media/vs-2022/asp-net-core-with-angular-solution-explorer.png" alt-text="Screenshot showing Solution Explorer":::
:::image type="content" source="media/vs-2022/asp-net-core-with-angular-solution-explorer.png" alt-text="Screenshot showing Solution Explorer.":::

Compared to the [standalone Angular template](../javascript/tutorial-create-angular-app.md), you see some new and modified files for integration with ASP.NET Core:

Expand All @@ -62,30 +62,30 @@ Make sure to install the following:

## Set the project properties

1. In Solution Explorer, right-click the ASP.NET Core project and choose **Properties**.
1. In Solution Explorer, right-click the **AngularWithASP.Server** project and choose **Properties**.

:::image type="content" source="media/vs-2022/asp-net-core-project-properties.png" alt-text="Screenshot showing Open project properties":::
:::image type="content" source="media/vs-2022/asp-net-core-project-properties-angular.png" alt-text="Screenshot showing Open project properties.":::

1. In the Properties page, open the **Debug** tab and select **Open debug launch profiles UI** option. Uncheck the **Launch Browser** option.
1. In the Properties page, open the **Debug** tab and select **Open debug launch profiles UI** option. Uncheck the **Launch Browser** option for the profile named after the ASP.NET Core project (or https, if present).

:::image type="content" source="media/vs-2022/asp-net-core-deselect-launch-browser.png" alt-text="Screenshot showing Debug launch profiles UI":::
:::image type="content" source="media/vs-2022/asp-net-core-deselect-launch-browser-angular.png" alt-text="Screenshot showing Debug launch profiles UI.":::

This prevents opening the web page with the source weather data.
This value prevents opening the web page with the source weather data.

>[!NOTE]
> In Visual Studio, *launch.json* stores the startup settings associated with the **Start** button in the Debug toolbar. Currently, *launch.json* must be located under the *.vscode* folder.
> In Visual Studio, *launch.json* stores the startup settings associated with the **Start** button in the Debug toolbar. *launch.json* must be located under the *.vscode* folder.

## Start the project

To start the project, press **F5** or select the **Start** button at the top of the window. You see two command prompts appear:
Press **F5** or select the **Start** button at the top of the window to start the app. Two command prompts appear:

- The ASP.NET Core API project running
- The Angular CLI running the ng start command

>[!NOTE]
> Check console output for messages, such as a message instructing you to update your version of Node.js.
> Check console output for messages. For example there might be a message to update Node.js.

You see an Angular app appear, populated using the API. If you don't see the app, see [Troubleshooting](#troubleshooting).
The Angular app appears and is populated via the API. If you don't see the app, see [Troubleshooting](#troubleshooting).

## Publish the project

Expand All @@ -94,25 +94,29 @@ Starting in Visual Studio 2022 version 17.3, you can publish the integrated solu
>[!NOTE]
> To use publish, create your JavaScript project using Visual Studio 2022 version 17.3 or later.

1. In Solution Explorer, right-click the ASP.NET Core project and choose **Add** > **Project Reference**.
1. In Solution Explorer, right-click the **AngularWithASP.Server** project and select **Add** > **Project Reference**.

1. Select the Angular project and choose **OK**.
The **angularwithasp.client*** project is selected.

1. Right-click the ASP.NET Core project in Solution Explorer and choose **Unload Project**.
1. Choose **OK**.

1. Right-click the ASP.NET Core project again and select **Edit Project File**.

This opens the *.csproj* file for the project.

Notice the `<ReferenceOutputAssembly>` has the value set to `false`.

1. In the *.csproj* file, update the project reference and add `<ReferenceOutputAssembly>` with the value set to `false`.

When you've updated the reference, it should look like this (substituting your own project folder and project name).
When you've updated the reference, it should look like the following.

```xml
<ProjectReference Include="..\angularprojectfolder\angularprojectname.esproj">
<ReferenceOutputAssembly>false</ReferenceOutputAssembly>
</ProjectReference>
<ProjectReference Include="..\angularwithasp.client\angularwithasp.client.esproj">
<ReferenceOutputAssembly>false</ReferenceOutputAssembly>
</ProjectReference>
```

1. Right.click the ASP.NET Core project and choose **Reload Project**.
1. Right-click the ASP.NET Core project and choose **Reload Project**.

1. In *Program.cs*, update the check for `Environment.IsDevelopment` so it looks like the following.

Expand All @@ -130,7 +134,7 @@ Starting in Visual Studio 2022 version 17.3, you can publish the integrated solu
}
```

1. To publish, right click the ASP.NET Core project, choose **Publish**, and select options to match your desired publish scenario, such as Azure, publish to a folder, et al.
1. To publish, right click the ASP.NET Core project, choose **Publish**, and select options to match your desired publish scenario, such as Azure, publish to a folder, etc.

The publish process takes more time than it does for just an ASP.NET Core project, since the `npm run build` command gets invoked when publishing.

Expand All @@ -150,7 +154,7 @@ If you see this issue, most likely the frontend started before the backend. Once

### Verify port

If the weather data does not load correctly, you may also need to verify that your ports are correct.
If the weather data doesn't load correctly, you may also need to verify that your ports are correct.

1. Go to the *launchSettings.json* file in your ASP.NET Core project (in the *Properties* folder). Get the port number from the `applicationUrl` property.

Expand All @@ -164,4 +168,4 @@ If the weather data does not load correctly, you may also need to verify that yo

## Next steps

For more information about SPA applications in ASP.NET Core, see the Angular section under [Developing Single Page Apps](/aspnet/core/client-side/spa/intro#developing-single-page-apps). The linked article provides additional context for project files such as *aspnetcore-https.js* and *proxy.conf.js*, although details of the implementation are different due to project template differences. For example, instead of a ClientApp folder, the Angular files are contained in a separate project.
For more information about SPA applications in ASP.NET Core, see the Angular section under [Developing Single Page Apps](/aspnet/core/client-side/spa/intro#developing-single-page-apps). The linked article provides additional context for project files such as *aspnetcore-https.js* and *proxy.conf.js*, although details of the implementation are different due to project template differences. For example, instead of a ClientApp folder, the Angular files are contained in a separate project.
Loading