About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page exhibits a Windows bias by focusing exclusively on Windows-based deployment and configuration patterns for ASP.NET apps in Azure App Service. All examples and instructions assume a Windows environment (e.g., Kudu CMD/PowerShell, Windows file paths, Visual Studio tooling), with no equivalent Linux-based guidance or examples. Linux scenarios are only mentioned in passing, without actionable steps or parity in documentation.
Recommendations:
- Add equivalent Linux-based instructions and examples for each configuration task, especially for scenarios where ASP.NET apps are hosted on Linux App Service plans or custom Linux containers.
- Provide Linux shell (bash) commands and file paths alongside Windows CMD/PowerShell examples, particularly for tasks like inspecting installed runtimes or accessing diagnostic logs.
- Include guidance for deploying and configuring ASP.NET apps using cross-platform tools (e.g., dotnet CLI, VS Code) in addition to Visual Studio.
- Clarify which instructions apply only to Windows App Service plans and provide clear, parallel sections for Linux where applicable.
- Reference Linux-specific troubleshooting and diagnostic tools (e.g., Kudu Bash, Linux logs location) where relevant.
Create pull request
Flagged Code Snippets
ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework"
ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework"
A value of `v4.0` means the latest CLR 4 version (.NET Framework 4.x) is used. A value of `v2.0` means a CLR 2 version (.NET Framework 3.5) is used.
## Set .NET Framework runtime version
By default, App Service uses the latest supported .NET Framework version to run your ASP.NET app. To run your app using .NET Framework 3.5 instead, run the following command in the [Cloud Shell](https://shell.azure.com) (v2.0 signifies CLR 2):
## Get detailed exceptions page
When your ASP.NET app generates an exception in the Visual Studio debugger, the browser displays a detailed exception page. A generic error message replaces that page in App Service. To display the detailed exception page in App Service, open the *web.config* file and add the `<customErrors mode="Off"/>` element under the `<system.web>` element. For example: