parent
ab437d1b67
commit
f0df4aaf7c
|
@ -32,7 +32,7 @@ The following tools are required:
|
|||
|
||||
## Recommended tools (Windows only)
|
||||
|
||||
* [Visual Studio](https://www.visualstudio.com/)'s robust Azure tools provide a GUI for most of the functionality described in this guide. Any edition of Visual Studio will work, including the free Visual Studio Community Edition. The tutorials are written to demonstrate development, deployment, and DevOps both with and without Visual Studio.
|
||||
* [Visual Studio](https://visualstudio.microsoft.com)'s robust Azure tools provide a GUI for most of the functionality described in this guide. Any edition of Visual Studio will work, including the free Visual Studio Community Edition. The tutorials are written to demonstrate development, deployment, and DevOps both with and without Visual Studio.
|
||||
|
||||
Confirm that Visual Studio has the following [workloads](/visualstudio/install/modify-visual-studio) installed:
|
||||
|
||||
|
|
|
@ -30,7 +30,7 @@ The following table compares ASP.NET Core to ASP.NET 4.x.
|
|||
|Build for Windows, macOS, or Linux|Build for Windows|
|
||||
|[Razor Pages](xref:razor-pages/index) is the recommended approach to create a Web UI as of ASP.NET Core 2.x. See also [MVC](xref:mvc/overview), [Web API](xref:tutorials/first-web-api), and [SignalR](xref:signalr/introduction).|Use [Web Forms](/aspnet/web-forms), [SignalR](/aspnet/signalr), [MVC](/aspnet/mvc), [Web API](/aspnet/web-api/), [WebHooks](/aspnet/webhooks/), or [Web Pages](/aspnet/web-pages)|
|
||||
|Multiple versions per machine|One version per machine|
|
||||
|Develop with Visual Studio, [Visual Studio for Mac](https://www.visualstudio.com/vs/visual-studio-mac/), or [Visual Studio Code](https://code.visualstudio.com/) using C# or F#|Develop with Visual Studio using C#, VB, or F#|
|
||||
|Develop with Visual Studio, [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/), or [Visual Studio Code](https://code.visualstudio.com/) using C# or F#|Develop with Visual Studio using C#, VB, or F#|
|
||||
|Higher performance than ASP.NET 4.x|Good performance|
|
||||
|[Choose .NET Framework or .NET Core runtime](/dotnet/standard/choosing-core-framework-server)|Use .NET Framework runtime|
|
||||
|
||||
|
|
|
@ -163,7 +163,7 @@ File configuration of the host is enabled by specifying the app's base path with
|
|||
|
||||
To add [environment variable configuration](xref:fundamentals/configuration/index#environment-variables-configuration-provider) of the host, call <xref:Microsoft.Extensions.Configuration.EnvironmentVariablesExtensions.AddEnvironmentVariables*> on the host builder. `AddEnvironmentVariables` accepts an optional user-defined prefix. The sample app uses a prefix of `PREFIX_`. The prefix is removed when the environment variables are read. When the sample app's host is configured, the environment variable value for `PREFIX_ENVIRONMENT` becomes the host configuration value for the `environment` key.
|
||||
|
||||
During development when using [Visual Studio](https://www.visualstudio.com/) or running an app with `dotnet run`, environment variables may be set in the *Properties/launchSettings.json* file. In [Visual Studio Code](https://code.visualstudio.com/), environment variables may be set in the *.vscode/launch.json* file during development. For more information, see <xref:fundamentals/environments>.
|
||||
During development when using [Visual Studio](https://visualstudio.microsoft.com) or running an app with `dotnet run`, environment variables may be set in the *Properties/launchSettings.json* file. In [Visual Studio Code](https://code.visualstudio.com/), environment variables may be set in the *.vscode/launch.json* file during development. For more information, see <xref:fundamentals/environments>.
|
||||
|
||||
[Command-line configuration](xref:fundamentals/configuration/index#command-line-configuration-provider) is added by calling <xref:Microsoft.Extensions.Configuration.CommandLineConfigurationExtensions.AddCommandLine*>. Command-line configuration is added last to permit command-line arguments to override configuration provided by the earlier configuration providers.
|
||||
|
||||
|
|
|
@ -118,7 +118,7 @@ The configuration defined by `CreateDefaultBuilder` can be overridden and augmen
|
|||
|
||||
::: moniker-end
|
||||
|
||||
The *content root* determines where the host searches for content files, such as MVC view files. When the app is started from the project's root folder, the project's root folder is used as the content root. This is the default used in [Visual Studio](https://www.visualstudio.com/) and the [dotnet new templates](/dotnet/core/tools/dotnet-new).
|
||||
The *content root* determines where the host searches for content files, such as MVC view files. When the app is started from the project's root folder, the project's root folder is used as the content root. This is the default used in [Visual Studio](https://visualstudio.microsoft.com) and the [dotnet new templates](/dotnet/core/tools/dotnet-new).
|
||||
|
||||
For more information on app configuration, see <xref:fundamentals/configuration/index>.
|
||||
|
||||
|
@ -213,7 +213,7 @@ Sets the app's environment.
|
|||
**Set using**: `UseEnvironment`
|
||||
**Environment variable**: `ASPNETCORE_ENVIRONMENT`
|
||||
|
||||
The environment can be set to any value. Framework-defined values include `Development`, `Staging`, and `Production`. Values aren't case sensitive. By default, the *Environment* is read from the `ASPNETCORE_ENVIRONMENT` environment variable. When using [Visual Studio](https://www.visualstudio.com/), environment variables may be set in the *launchSettings.json* file. For more information, see <xref:fundamentals/environments>.
|
||||
The environment can be set to any value. Framework-defined values include `Development`, `Staging`, and `Production`. Values aren't case sensitive. By default, the *Environment* is read from the `ASPNETCORE_ENVIRONMENT` environment variable. When using [Visual Studio](https://visualstudio.microsoft.com), environment variables may be set in the *launchSettings.json* file. For more information, see <xref:fundamentals/environments>.
|
||||
|
||||
```csharp
|
||||
WebHost.CreateDefaultBuilder(args)
|
||||
|
|
|
@ -204,9 +204,9 @@ If the built-in servers don't meet the app's requirements, a custom server imple
|
|||
|
||||
The server is launched when the Integrated Development Environment (IDE) or editor starts the app:
|
||||
|
||||
* [Visual Studio](https://www.visualstudio.com/vs/) – Launch profiles can be used to start the app and server with either [IIS Express](/iis/extensions/introduction-to-iis-express/iis-express-overview)/[ASP.NET Core Module](xref:host-and-deploy/aspnet-core-module) or the console.
|
||||
* [Visual Studio](https://visualstudio.microsoft.com) – Launch profiles can be used to start the app and server with either [IIS Express](/iis/extensions/introduction-to-iis-express/iis-express-overview)/[ASP.NET Core Module](xref:host-and-deploy/aspnet-core-module) or the console.
|
||||
* [Visual Studio Code](https://code.visualstudio.com/) – The app and server are started by [Omnisharp](https://github.com/OmniSharp/omnisharp-vscode), which activates the CoreCLR debugger.
|
||||
* [Visual Studio for Mac](https://www.visualstudio.com/vs/mac/) – The app and server are started by the [Mono Soft-Mode Debugger](https://www.mono-project.com/docs/advanced/runtime/docs/soft-debugger/).
|
||||
* [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/) – The app and server are started by the [Mono Soft-Mode Debugger](https://www.mono-project.com/docs/advanced/runtime/docs/soft-debugger/).
|
||||
|
||||
When launching the app from a command prompt in the project's folder, [dotnet run](/dotnet/core/tools/dotnet-run) launches the app and server (Kestrel and HTTP.sys only). The configuration is specified by the `-c|--configuration` option, which is set to either `Debug` (default) or `Release`. If launch profiles are present in a *launchSettings.json* file, use the `--launch-profile <NAME>` option to set the launch profile (for example, `Development` or `Production`). For more information, see [dotnet run](/dotnet/core/tools/dotnet-run) and [.NET Core distribution packaging](/dotnet/core/build/distribution-packaging).
|
||||
|
||||
|
|
|
@ -24,7 +24,7 @@ See also [Create your first pipeline with Azure Pipelines](/azure/devops/pipelin
|
|||
|
||||
This tutorial assumes the following software is installed:
|
||||
|
||||
* [Visual Studio](https://www.visualstudio.com)
|
||||
* [Visual Studio](https://visualstudio.microsoft.com)
|
||||
* [!INCLUDE [](~/includes/net-core-sdk-download-link.md)]
|
||||
* [Git](https://git-scm.com/downloads) for Windows
|
||||
|
||||
|
|
|
@ -16,7 +16,7 @@ Visual Studio 2017 supports building, debugging, and running containerized ASP.N
|
|||
## Prerequisites
|
||||
|
||||
* [Docker for Windows](https://docs.docker.com/docker-for-windows/install/)
|
||||
* [Visual Studio 2017](https://www.visualstudio.com/) with the **.NET Core cross-platform development** workload
|
||||
* [Visual Studio 2017](https://visualstudio.microsoft.com) with the **.NET Core cross-platform development** workload
|
||||
|
||||
## Installation and setup
|
||||
|
||||
|
|
|
@ -12,7 +12,7 @@ uid: host-and-deploy/iis/development-time-iis-support
|
|||
|
||||
By [Sourabh Shirhatti](https://twitter.com/sshirhatti) and [Luke Latham](https://github.com/guardrex)
|
||||
|
||||
This article describes [Visual Studio](https://www.visualstudio.com/vs/) support for debugging ASP.NET Core apps running with IIS on Windows Server. This topic walks through enabling this scenario and setting up a project.
|
||||
This article describes [Visual Studio](https://visualstudio.microsoft.com) support for debugging ASP.NET Core apps running with IIS on Windows Server. This topic walks through enabling this scenario and setting up a project.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
# [Visual Studio](#tab/visual-studio)
|
||||
|
||||
* [Visual Studio 2017 version 15.7.3 or later](https://www.visualstudio.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [Visual Studio 2017 version 15.7.3 or later](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [.NET Core 2.1 SDK or later](https://www.microsoft.com/net/download/windows)
|
||||
|
||||
# [Visual Studio Code](#tab/visual-studio-code)
|
||||
|
@ -11,7 +11,7 @@
|
|||
|
||||
# [Visual Studio for Mac](#tab/visual-studio-mac)
|
||||
|
||||
* [Visual Studio for Mac version 7.6.10 or later](https://www.visualstudio.com/downloads/)
|
||||
* [Visual Studio for Mac version 7.6.10 or later](https://visualstudio.microsoft.com/downloads/)
|
||||
* [.NET Core SDK 2.1 or later](https://www.microsoft.com/net/download/all)
|
||||
|
||||
---
|
|
@ -1,2 +1,2 @@
|
|||
* [Visual Studio for Mac version 7.7 or later](https://www.visualstudio.com/downloads/)
|
||||
* [Visual Studio for Mac version 7.7 or later](https://visualstudio.microsoft.com/downloads/)
|
||||
* [.NET Core SDK 2.2 or later](https://www.microsoft.com/net/download/all)
|
|
@ -129,7 +129,7 @@ The most robust approach is to specify a [model](xref:mvc/models/model-binding)
|
|||
|
||||
Using a viewmodel to pass data to a view allows the view to take advantage of *strong* type checking. *Strong typing* (or *strongly typed*) means that every variable and constant has an explicitly defined type (for example, `string`, `int`, or `DateTime`). The validity of types used in a view is checked at compile time.
|
||||
|
||||
[Visual Studio](https://www.visualstudio.com/vs/) and [Visual Studio Code](https://code.visualstudio.com/) list strongly typed class members using a feature called [IntelliSense](/visualstudio/ide/using-intellisense). When you want to see the properties of a viewmodel, type the variable name for the viewmodel followed by a period (`.`). This helps you write code faster with fewer errors.
|
||||
[Visual Studio](https://visualstudio.microsoft.com) and [Visual Studio Code](https://code.visualstudio.com/) list strongly typed class members using a feature called [IntelliSense](/visualstudio/ide/using-intellisense). When you want to see the properties of a viewmodel, type the variable name for the viewmodel followed by a period (`.`). This helps you write code faster with fewer errors.
|
||||
|
||||
Specify a model using the `@model` directive. Use the model with `@Model`:
|
||||
|
||||
|
|
|
@ -328,7 +328,7 @@ The [sample app](https://github.com/aspnet/AspNetCore.Docs/tree/master/aspnetcor
|
|||
| Message app (the SUT) | *src/RazorPagesProject* | Allows a user to add, delete one, delete all, and analyze messages. |
|
||||
| Test app | *tests/RazorPagesProject.Tests* | Used to integration test the SUT. |
|
||||
|
||||
The tests can be run using the built-in test features of an IDE, such as [Visual Studio](https://www.visualstudio.com/vs/). If using [Visual Studio Code](https://code.visualstudio.com/) or the command line, execute the following command at a command prompt in the *tests/RazorPagesProject.Tests* folder:
|
||||
The tests can be run using the built-in test features of an IDE, such as [Visual Studio](https://visualstudio.microsoft.com). If using [Visual Studio Code](https://code.visualstudio.com/) or the command line, execute the following command at a command prompt in the *tests/RazorPagesProject.Tests* folder:
|
||||
|
||||
```console
|
||||
dotnet test
|
||||
|
|
|
@ -33,7 +33,7 @@ The sample project is composed of two apps:
|
|||
| Message app | *src/RazorPagesTestSample* | Allows a user to add, delete one, delete all, and analyze messages. |
|
||||
| Test app | *tests/RazorPagesTestSample.Tests* | Used to unit test the message app: Data access layer (DAL) and Index page model. |
|
||||
|
||||
The tests can be run using the built-in test features of an IDE, such as [Visual Studio](https://www.visualstudio.com/vs/). If using [Visual Studio Code](https://code.visualstudio.com/) or the command line, execute the following command at a command prompt in the *tests/RazorPagesTestSample.Tests* folder:
|
||||
The tests can be run using the built-in test features of an IDE, such as [Visual Studio](https://visualstudio.microsoft.com). If using [Visual Studio Code](https://code.visualstudio.com/) or the command line, execute the following command at a command prompt in the *tests/RazorPagesTestSample.Tests* folder:
|
||||
|
||||
```console
|
||||
dotnet test
|
||||
|
|
|
@ -28,7 +28,7 @@ In this tutorial, you learn how to:
|
|||
# [Visual Studio](#tab/visual-studio)
|
||||
|
||||
* [.NET Core SDK 2.2 or later](https://www.microsoft.com/net/download/all)
|
||||
* [Visual Studio 2017 version 15.9 or later](https://www.visualstudio.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [Visual Studio 2017 version 15.9 or later](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/)
|
||||
|
||||
# [Visual Studio Code](#tab/visual-studio-code)
|
||||
|
@ -41,7 +41,7 @@ In this tutorial, you learn how to:
|
|||
# [Visual Studio for Mac](#tab/visual-studio-mac)
|
||||
|
||||
* [.NET Core SDK 2.2 or later](https://www.microsoft.com/net/download/all)
|
||||
* [Visual Studio for Mac version 7.7 or later](https://www.visualstudio.com/downloads/)
|
||||
* [Visual Studio for Mac version 7.7 or later](https://visualstudio.microsoft.com/downloads/)
|
||||
* [MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/)
|
||||
|
||||
---
|
||||
|
|
|
@ -28,7 +28,7 @@ In this tutorial, you learn how to:
|
|||
|
||||
# [Visual Studio](#tab/visual-studio)
|
||||
|
||||
* [Visual Studio 2017 version 15.9 or later](https://www.visualstudio.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [Visual Studio 2017 version 15.9 or later](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) with the **ASP.NET and web development** workload
|
||||
* [.NET Core SDK 2.2 or later](https://www.microsoft.com/net/download/all)
|
||||
* [Node.js](https://nodejs.org/) with [npm](https://www.npmjs.com/)
|
||||
|
||||
|
|
Loading…
Reference in New Issue