76 lines
4.1 KiB
Markdown
76 lines
4.1 KiB
Markdown
---
|
||
title: Troubleshoot for ASP.NET Core
|
||
author: Rick-Anderson
|
||
description: Understand and troubleshoot warnings and errors with ASP.NET Core projects.
|
||
manager: wpickett
|
||
ms.author: riande
|
||
ms.date: 04/05/2018
|
||
ms.prod: asp.net-core
|
||
ms.technology: aspnet
|
||
ms.topic: content
|
||
uid: test/troubleshoot
|
||
---
|
||
# Troubleshoot ASP.NET Core projects
|
||
|
||
By [Rick Anderson](https://twitter.com/RickAndMSFT)
|
||
|
||
The following links provide troubleshooting guidance:
|
||
|
||
* [Troubleshoot ASP.NET Core on Azure App Service](xref:host-and-deploy/azure-apps/troubleshoot)
|
||
* [Troubleshoot ASP.NET Core on IIS](xref:host-and-deploy/iis/troubleshoot)
|
||
* [Common errors reference for Azure App Service and IIS with ASP.NET Core](xref:host-and-deploy/azure-iis-errors-reference)
|
||
* [YouTube: Diagnosing issues in ASP.NET Core Applications](https://www.youtube.com/watch?v=RYI0DHoIVaA)
|
||
|
||
<a name="sdk"></a>
|
||
## .NET Core SDK warnings
|
||
|
||
### Both the 32 bit and 64 bit versions of the .NET Core SDK are installed
|
||
In the **New Project** dialog for ASP.NET Core, you may see the following warning:
|
||
|
||
Both 32 and 64 bit versions of the .NET Core SDK are installed. Only templates from the 64 bit version(s) installed at C:\Program Files\dotnet\sdk\" will be displayed.
|
||
|
||
|
||
|
||
This warning appears when both 32-bit (x86) and 64-bit (x64) versions of the [.NET Core SDK](https://www.microsoft.com/net/download/all) are installed. Common reasons both versions can be installed include:
|
||
|
||
* You originally downloaded the .NET Core SDK installer using a 32-bit machine, but then copied it across and installed it on a 64-bit machine.
|
||
* The 32-bit .NET Core SDK was installed by another application.
|
||
* The wrong version was downloaded and installed.
|
||
|
||
Uninstall the 32-bit .NET Core SDK to prevent this warning. Uninstall from **Control Panel** > **Programs and Features** > **Uninstall or change a program**. If you understand why the warning occurs and its implications, you can ignore the warning.
|
||
|
||
### The .NET Core SDK is installed in multiple locations
|
||
In the **New Project** dialog for ASP.NET Core you may see the following warning:
|
||
|
||
The .NET Core SDK is installed in multiple locations. Only templates from the SDK(s) installed at 'C:\Program Files\dotnet\sdk\' will be displayed.
|
||
|
||
|
||
|
||
You see this message when you have at least one installation of the .NET Core SDK in a directory outside of *C:\Program Files\dotnet\sdk\*. Usually that happens when the .NET Core SDK has been deployed on a machine using copy/paste instead of the MSI installer.
|
||
|
||
Uninstall the 32-bit .NET Core SDK to prevent this warning. Uninstall from **Control Panel** > **Programs and Features** > **Uninstall or change a program**. If you understand why the warning occurs and its implications, you can ignore the warning.
|
||
|
||
### No .NET Core SDKs were detected
|
||
In the **New Project** dialog for ASP.NET Core you may see the following warning:
|
||
|
||
**No .NET Core SDKs were detected, ensure they are included in the environment variable 'PATH'**
|
||
|
||
|
||
|
||
This warning appears when the environment variable `PATH` doesn’t point to any .NET Core SDKs on the machine. To resolve this problem:
|
||
|
||
* Install or verify the .NET Core SDK is installed.
|
||
* Verify the `PATH` environment variable points to the location the SDK is installed. The installer normally sets the `PATH`.
|
||
|
||
::: moniker range=">= aspnetcore-2.1"
|
||
|
||
### Use of IHtmlHelper.Partial may result in application deadlocks
|
||
|
||
In ASP.NET Core 2.1 and later, calling `Html.Partial` results in an analyzer warning due to the potential for deadlocks. The warning message is:
|
||
|
||
*Use of IHtmlHelper.Partial may result in application deadlocks. Consider using `<partial>` Tag Helper or `IHtmlHelper.PartialAsync`.*
|
||
|
||
Calls to `@Html.Partial` should be replaced by `@await Html.PartialAsync` or the partial tag helper `<partial name="_Partial" />`.
|
||
|
||
::: moniker-end
|