commit translated contents

Author: olprod

docs/core/additional-tools/dotnet-svcutil-guide.md

@@ -4,12 +4,12 @@ description: Microsoft WCF dotnet-svcutil 工具概述，该工具添加了 .NET
 author: mlacouture
 ms.date: 02/22/2019
 ms.custom: seodec18
-ms.openlocfilehash: b5dfb84f19c3748daa303c828cbe881f1582eb76
-ms.sourcegitcommit: 438919211260bb415fc8f96ca3eabc33cf2d681d
+ms.openlocfilehash: 5e361ce85bec696fe5d76c4f43a444c543a9012d
+ms.sourcegitcommit: ca2ca60e6f5ea327f164be7ce26d9599e0f85fe4
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 04/16/2019
-ms.locfileid: "59612807"
+ms.lasthandoff: 05/06/2019
+ms.locfileid: "65063295"
 ---
 # <a name="wcf-dotnet-svcutil-tool-for-net-core"></a>.NET Core 的 WCF dotnet-svcutil 工具
 
@@ -53,99 +53,100 @@ public interface ISayHello
 
 1. 为项目创建一个名为“HelloSvcutil”的目录，并将其设置为当前目录，如以下示例所示：
 
-```console
-mkdir HelloSvcutil
-cd HelloSvcutil
-```
+    ```console
+    mkdir HelloSvcutil
+    cd HelloSvcutil
+    ```
 
 2. 在该目录中使用 [`dotnet new`](../tools/dotnet-new.md) 命令创建新的 C# Web 项目，如下所示：
 
-```console
-dotnet new web
-```
+    ```console
+    dotnet new web
+    ```
 
-3. 安装 [`dotnet-svcutil` NuGet 包](https://nuget.org/packages/dotnet-svcutil)作为 CLI 工具：
-# <a name="dotnet-svcutil-2xtabdotnetsvcutil2x"></a>[dotnet-svcutil 2.x](#tab/dotnetsvcutil2x)
+3. 安装 [`dotnet-svcutil` NuGet 包](https://nuget.org/packages/dotnet-svcutil)作为 CLI 工具： <!-- markdownlint-disable MD023 -->
+    # <a name="dotnet-svcutil-2xtabdotnetsvcutil2x"></a>[dotnet-svcutil 2.x](#tab/dotnetsvcutil2x)
 
-```console
-dotnet tool install --global dotnet-svcutil
-```
+    ```console
+    dotnet tool install --global dotnet-svcutil
+    ```
 
-# <a name="dotnet-svcutil-1xtabdotnetsvcutil1x"></a>[dotnet-svcutil 1.x](#tab/dotnetsvcutil1x)
-在编辑器中打开 `HelloSvcutil.csproj` 项目文件，编辑 `Project` 元素，并使用下面的代码添加 [`dotnet-svcutil` NuGet 包](https://nuget.org/packages/dotnet-svcutil)作为 CLI 工具引用：
+    # <a name="dotnet-svcutil-1xtabdotnetsvcutil1x"></a>[dotnet-svcutil 1.x](#tab/dotnetsvcutil1x)
+    在编辑器中打开 `HelloSvcutil.csproj` 项目文件，编辑 `Project` 元素，并使用下面的代码添加 [`dotnet-svcutil` NuGet 包](https://nuget.org/packages/dotnet-svcutil)作为 CLI 工具引用：
 
-```xml
-<ItemGroup>
-  <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
-</ItemGroup>
-```
+    ```xml
+    <ItemGroup>
+      <DotNetCliToolReference Include="dotnet-svcutil" Version="1.0.*" />
+    </ItemGroup>
+    ```
 
-然后使用 [`dotnet restore`](../tools/dotnet-restore.md) 命令还原 dotnet-svcutil 包，如下所示：
+    然后使用 [`dotnet restore`](../tools/dotnet-restore.md) 命令还原 dotnet-svcutil 包，如下所示：
 
-```console
-dotnet restore
-```
+    ```console
+    dotnet restore
+    ```
 
----
+    ---
 
 4. 运行 dotnet-svcutil 命令生成 Web 服务引用文件，如下所示：
-# <a name="dotnet-svcutil-2xtabdotnetsvcutil2x"></a>[dotnet-svcutil 2.x](#tab/dotnetsvcutil2x)
 
-```console
-dotnet-svcutil http://contoso.com/SayHello.svc
-```
+    # <a name="dotnet-svcutil-2xtabdotnetsvcutil2x"></a>[dotnet-svcutil 2.x](#tab/dotnetsvcutil2x)
 
-# <a name="dotnet-svcutil-1xtabdotnetsvcutil1x"></a>[dotnet-svcutil 1.x](#tab/dotnetsvcutil1x)
+    ```console
+    dotnet-svcutil http://contoso.com/SayHello.svc
+    ```
 
-```console
-dotnet svcutil http://contoso.com/SayHello.svc
-```
+    # <a name="dotnet-svcutil-1xtabdotnetsvcutil1x"></a>[dotnet-svcutil 1.x](#tab/dotnetsvcutil1x)
 
----
+    ```console
+    dotnet svcutil http://contoso.com/SayHello.svc
+    ```
+
+    ---
 
 生成的文件保存为 _HelloSvcutil/ServiceReference/Reference.cs_。 dotnet-svcutil 工具还向项目添加代理代码所需的适当 WCF 包作为包引用。
 
 ## <a name="using-the-service-reference"></a>使用服务引用
 
 1. 使用 [`dotnet restore`](../tools/dotnet-restore.md) 命令还原 WCF 包，如下所示：
 
-```console
-dotnet restore
-```
+    ```console
+    dotnet restore
+    ```
 
 2. 找到要使用的客户端类和操作的名称。 `Reference.cs` 将包含一个继承自 `System.ServiceModel.ClientBase` 的类，其方法可用于调用服务上的操作。 在本例中，想要调用 SayHello 服务的 Hello 操作。 `ServiceReference.SayHelloClient` 是客户端类的名称，它有一个名为 `HelloAsync` 的方法，可用于调用该操作。
 
 3. 在编辑器中打开 `Startup.cs` 文件，并在顶部为服务引用命名空间添加一个 using 语句：
 
-```csharp
-using ServiceReference;
-```
+    ```csharp
+    using ServiceReference;
+    ```
 
- 4. 编辑 `Configure` 方法来调用 Web 服务。 为此，可以创建一个继承自 `ClientBase` 的类的实例，并在客户端对象上调用此方法：
+4. 编辑 `Configure` 方法来调用 Web 服务。 为此，可以创建一个继承自 `ClientBase` 的类的实例，并在客户端对象上调用此方法：
 
-```csharp
-public void Configure(IApplicationBuilder app, IHostingEnvironment env)
-{
-    if (env.IsDevelopment())
+    ```csharp
+    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
     {
-        app.UseDeveloperExceptionPage();
+        if (env.IsDevelopment())
+        {
+            app.UseDeveloperExceptionPage();
+        }
+
+        app.Run(async (context) =>
+        {
+            var client = new SayHelloClient();
+            var response = await client.HelloAsync();
+            await context.Response.WriteAsync(response);
+        });
     }
 
-    app.Run(async (context) =>
-    {
-        var client = new SayHelloClient();
-        var response = await client.HelloAsync();
-        await context.Response.WriteAsync(response);
-    });
-}
-
-```
+    ```
 
 5. 使用 [`dotnet run`](../tools/dotnet-run.md) 命令运行应用程序，如下所示：
 
-```console
-dotnet run
-```
+    ```console
+    dotnet run
+    ```
 
 6. 导航到在 Web 浏览器的控制台中列出的 URL（例如，`http://localhost:5000`）。
 

docs/core/build/distribution-packaging.md

@@ -1,19 +1,22 @@
 ---
 title: .NET Core 分发打包
 description: 了解如何为 .NET Core 打包、命名并进行版本控制以进行分发。
-author: bleroy
-ms.date: 06/28/2017
+author: tmds
+ms.date: 03/02/2018
 ms.custom: seodec18
-ms.openlocfilehash: be5767351ad1cdac15c73f718f67a0d120cf65b0
-ms.sourcegitcommit: e6ad58812807937b03f5c581a219dcd7d1726b1d
+ms.openlocfilehash: b961d84053dc41e75e002c8c12419fdef99ded4b
+ms.sourcegitcommit: 2701302a99cafbe0d86d53d540eb0fa7e9b46b36
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 12/10/2018
-ms.locfileid: "53170413"
+ms.lasthandoff: 04/28/2019
+ms.locfileid: "64585258"
 ---
 # <a name="net-core-distribution-packaging"></a>.NET Core 分发打包
 
-由于 .NET Core 现已可用于更多平台，因此了解如何为其打包、命名并进行版本控制将很有用。 这样，无论用户选择在哪里运行 .NET，包维护人员均可以帮助确保获得一致的体验。
+由于 .NET Core 现已可用于更多平台，因此了解如何为其打包、命名并进行版本控制将很有用。 这样，无论用户选择在哪里运行 .NET，包维护人员均可以帮助确保获得一致的体验。 本文对以下用户非常有用：
+
+* 尝试从源生成 .NET Core。
+* 想要更改 .NET Core CLI，但更改可能会影响生成的布局或包。
 
 ## <a name="disk-layout"></a>磁盘布局
 
@@ -48,32 +51,32 @@ ms.locfileid: "53170413"
 
 主机只有一个，不过大部分的其他组件都在带有版本的目录中（2、3、5 和 6）。 这意味着系统上可存在多个版本，因为它们是并排安装的。
 
-- (2) **host/fxr/\<fxr version>** 包含了主机所使用的框架解析逻辑。 主机采用已安装的最新 hostfxr。 在执行 .NET Core 应用程序时，hostfxr 负责选择合适的运行时。 例如，.NET Core 2.0.0 的应用程序会使用 2.0.5 运行时（如果可用）。 同样，hostfxr 在开发期间也会选择适当的 SDK。
+- (2) **host/fxr/\<fxr version>** 包含了主机所使用的框架解析逻辑。 主机采用已安装的最新 hostfxr。 在执行 .NET Core 应用程序时，hostfxr 负责选择合适的运行时。 例如，为 .NET Core 2.0.0 生成的应用程序会使用 2.0.5 运行时（如果可用）。 同样，hostfxr 在开发期间也会选择适当的 SDK。
 
-- (3) **sdk/\<sdk version>** SDK（也称为“工具”）是一组托管工具，可用于编写和生成 .NET Core 库和应用程序。 SDK 包括 CLI、Roslyn 编译器、MSBuild 及相关生成任务和目标、NuGet、新项目模板等。
+- (3) **sdk/\<sdk version>** SDK（也称为“工具”）是一组托管工具，可用于编写和生成 .NET Core 库和应用程序。 SDK 包括 .NET Core 命令行接口 (CLI)、托管的语言编译器、MSBuild 及相关生成任务和目标、NuGet、新项目模板等。
 
-- (4) **sdk/NuGetFallbackFolder** 包含 `dotnet restore` 步骤中 SDK 所使用的 NuGet 包的缓存。
+- (4) **sdk/NuGetFallbackFolder** 包含 SDK 在还原操作期间使用的 NuGet 包的缓存，例如在运行 `dotnet restore` 或 `dotnet build /t:Restore` 时。
 
 “共享”文件夹包含框架。 共享框架提供一组位于中心位置的库，从而让不同的应用程序使用。
 
 - (5) **shared/Microsoft.NETCore.App/\<runtime version>** 此框架包含.NET Core 运行时和支持托管库。
 
 - (6,7) **shared/Microsoft.AspNetCore.{App,All}/\<aspnetcore version>** 包含 ASP.NET Core 库。 已开发且支持 `Microsoft.AspNetCore.App` 下的库（作为 .NET Core 项目的一部分）。 `Microsoft.AspNetCore.All` 下的库是一个超集，其中还包含第三方库。
 
-- (8) **LICENSE.txt,ThirdPartyNotices.txt** 是 .NET Core 许可证和 .NET Core 中使用的第三方库的许可证。
+- (8) **LICENSE.txt,ThirdPartyNotices.txt** 分别是 .NET Core 许可证和 .NET Core 中使用的第三方库的许可证。
 
 - (9,10) **dotnet.1.gz, dotnet** `dotnet.1.gz` 是 dotnet 手册页。 `dotnet` 是指向 dotnet 主机 (1) 的符号链接。 这些文件安装在已知位置用于系统集成。
 
 ## <a name="recommended-packages"></a>推荐的包
 
 .NET Core 版本控制基于运行时组件 `[major].[minor]` 版本号。
-SDK 版本采用同样的 `[major].[minor]`，并有一个独立的 `[patch]`，它为 SDK 合并了功能和修补语义。
-例如:SDK 版本 2.2.302 是支持 2.2 运行时的 SDK 的第 3 个功能版本的第 2 个补丁版本。
+SDK 版本采用相同的 `[major].[minor]`，并有一个独立的 `[patch]`，它为 SDK 合并了功能和修补语义。
+例如:SDK 版本 2.2.302 是支持 2.2 运行时的 SDK 的第 3 个功能版本的第 2 个补丁版本。 有关版本控制的工作原理的详细信息，请参阅 [.NET Core 版本控制概述](../versions/index.md)。
 
-一些包在自己的名称中就包含一部分版本号。 这能帮助最终用户安装特定版本。
-版本名称中不包含版本的剩余部分。 这允许 OS 包管理器更新这些包（例如，自动安装安全修补程序）。
+一些包在自己的名称中就包含一部分版本号。 这允许你安装特定版本。
+版本名称中不包含版本的剩余部分。 这允许 OS 包管理器更新这些包（例如，自动安装安全修补程序）。 支持的包管理器特定于 Linux。
 
-下表显示推荐的包。
+下表显示了推荐的包：
 
 | name                                    | 示例                | 用例：安装 ...           | 包含           | 依赖项                                   | 版本            |
 |-----------------------------------------|------------------------|---------------------------------|--------------------|------------------------------------------------|--------------------|
@@ -87,21 +90,21 @@ SDK 版本采用同样的 `[major].[minor]`，并有一个独立的 `[patch]`，
 
 大多数分发都需要从源中构建所有项目。 这对包有一些影响：
 
-- 不能简单地从源中构建 `shared/Microsoft.AspNetCore.All` 下的第三方库。 因此 `aspnetcore-runtime` 包中省略了该文件夹。
+- 不能简单地从源生成 `shared/Microsoft.AspNetCore.All` 下的第三方库。 因此 `aspnetcore-runtime` 包中省略了该文件夹。
 
 - 使用 `nuget.org` 中的二进制项目填充了 `NuGetFallbackFolder`。 它应保留为空。
 
-多个 `dotnet-sdk` 包可能会为 `NuGetFallbackFolder` 提供同样的文件。 要避免包管理器出现问题，这些文件应完全相同（包括校验和、修改日期等等）。
+多个 `dotnet-sdk` 包可能会为 `NuGetFallbackFolder` 提供同样的文件。 若要避免包管理器出现问题，这些文件应完全相同（包括校验和、修改日期等等）。
 
-#### <a name="preview-versions"></a>预览版
+### <a name="preview-versions"></a>预览版
 
-包维护人员可以决定提供共享框架和 SDK 的预览版。 提供预览版可能会使用 `dotnet-sdk-[major].[minor].[sdk feat]xx`、`aspnetcore-runtime-[major].[minor]` 和 `dotnet-runtime-[major].[minor]` 包。 对于预览版，包的主版本号必须设为 0。 这样最终版本将被安装为此包的升级版。
+包维护人员可以决定提供共享框架和 SDK 的预览版。 可以使用 `dotnet-sdk-[major].[minor].[sdk feat]xx`、`aspnetcore-runtime-[major].[minor]` 或 `dotnet-runtime-[major].[minor]` 包提供预览版。 对于预览版，包的主版本号必须设为 0。 这样最终版本将被安装为此包的升级版。
 
-#### <a name="patch-packages"></a>修补程序包
+### <a name="patch-packages"></a>修补程序包
 
-由于包的修补版本可能会带来重大更改，包维护人员可能要提供修补程序包。 这些包允许安装非自动升级的特定修补版本。 因为这些修补程序包不会随（安全）修补程序升级，所以只应在极少数情况使用。
+由于包的补丁版本可能会带来重大更改，包维护人员可能要提供_补丁包_。 这些包允许安装非自动升级的特定补丁版本。 因为这些补丁包不会随（安全）修补程序升级，所以只应在极少数情况下使用。
 
-下表显示推荐的包以及修补程序包。
+下表显示了推荐的包和**补丁包**：
 
 | name                                           | 示例                  | 包含         | 依赖项                                              |
 |------------------------------------------------|--------------------------|------------------|-----------------------------------------------------------|

docs/core/docker/build-container.md

@@ -4,12 +4,12 @@ description: 在本教程中，你将了解如何使用 Docker 容器化 .NET Co
 ms.date: 04/10/2019
 ms.topic: tutorial
 ms.custom: mvc, seodec18
-ms.openlocfilehash: fcbac0e0d17d2481d42e715a7f2790586e31d085
-ms.sourcegitcommit: 8080271c246b57f4fb68c28369634bff46843424
+ms.openlocfilehash: a96f96bd91976b0966fb7e8d0c8fb6fb7842cfe3
+ms.sourcegitcommit: 8699383914c24a0df033393f55db3369db728a7b
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 04/13/2019
-ms.locfileid: "59553831"
+ms.lasthandoff: 05/15/2019
+ms.locfileid: "65631866"
 ---
 # <a name="tutorial-containerize-a-net-core-app"></a>教程：使 .NET Core 应用程序容器化
 
@@ -412,3 +412,4 @@ docker rmi mcr.microsoft.com/dotnet/core/runtime:2.2
 * [试学“ASP.NET Core 微服务”教程。](https://dotnet.microsoft.com/learn/web/aspnet-microservice-tutorial/intro)
 * [查看支持容器的 Azure 服务。](https://azure.microsoft.com/en-us/overview/containers/)
 * [了解 Dockerfile 命令。](https://docs.docker.com/engine/reference/builder/)
+* [了解用于 Visual Studio 的容器工具](/visualstudio/containers/overview)

docs/core/docker/intro-net-docker.md

@@ -3,12 +3,12 @@ title: Docker 简介
 description: 本文简要概述 .NET Core 应用程序上下文中的 Docker。
 ms.date: 03/20/2019
 ms.custom: mvc, seodec18
-ms.openlocfilehash: acf1307c241d9462278bc0fce5cf59fdde0750a3
-ms.sourcegitcommit: 859b2ba0c74a1a5a4ad0d59a3c3af23450995981
+ms.openlocfilehash: d0bce09d7acdcf474fbb8849c8fc82dae4a69598
+ms.sourcegitcommit: 2701302a99cafbe0d86d53d540eb0fa7e9b46b36
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 04/11/2019
-ms.locfileid: "59480724"
+ms.lasthandoff: 04/28/2019
+ms.locfileid: "64753296"
 ---
 # <a name="introduction-to-net-and-docker"></a>.NET 和 Docker 简介
 
@@ -72,5 +72,7 @@ Microsoft 提供适合特定场景的映像。 例如，[ASP.NET Core 存储库]
 
 ## <a name="next-steps"></a>后续步骤
 
-* [了解如何容器化 .NET Core 应用。](build-docker-netcore-container.md)
-* [试学“ASP.NET Core 微服务”教程。](https://dotnet.microsoft.com/learn/web/aspnet-microservice-tutorial/intro)
+* [了解如何使 .NET Core 应用程序容器化。](build-docker-netcore-container.md)
+* [了解如何容器化 ASP.NET Core 应用程序。](/aspnet/core/host-and-deploy/docker/building-net-docker-images)
+* [试用“学习 ASP.NET Core 微服务”教程。](https://dotnet.microsoft.com/learn/web/aspnet-microservice-tutorial/intro)
+* [了解 Visual Studio 中的容器工具](/visualstudio/containers/overview)

docs/core/tools/dotnet-add-package.md

@@ -1,17 +1,21 @@
 ---
 title: dotnet add package 命令
 description: “dotnet add package”命令可便于添加对项目的 NuGet 包引用。
-ms.date: 12/04/2018
-ms.openlocfilehash: 159b208feafb82e267629ea47dcef02d6b575055
-ms.sourcegitcommit: e6ad58812807937b03f5c581a219dcd7d1726b1d
+ms.date: 04/24/2019
+ms.openlocfilehash: 07cb6cd8e7873def6f969a54c1f7b9a7325f9491
+ms.sourcegitcommit: 8699383914c24a0df033393f55db3369db728a7b
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 12/10/2018
-ms.locfileid: "53169997"
+ms.lasthandoff: 05/15/2019
+ms.locfileid: "65632270"
 ---
 # <a name="dotnet-add-package"></a>dotnet add package
 
+**本文适用于：✓** .NET Core 1.x SDK 及更高版本
+
+<!-- todo: uncomment when all CLI commands are reviewed
 [!INCLUDE [topic-appliesto-net-core-all](../../../includes/topic-appliesto-net-core-all.md)]
+-->
 
 ## <a name="name"></a>name
 
@@ -78,11 +82,11 @@ info : PackageReference for package 'Newtonsoft.Json' version '12.0.1' added to
 
 * **`--package-directory <PACKAGE_DIRECTORY>`**
 
-  将包还原到指定的目录。
+  要在其中还原包的目录。
 
 * **`-s|--source <SOURCE>`**
 
-  使用还原操作期间的特定 NuGet 包源。
+  要在还原操作期间使用的 NuGet 包源。
 
 * **`-v|--version <VERSION>`**
 
@@ -106,4 +110,4 @@ info : PackageReference for package 'Newtonsoft.Json' version '12.0.1' added to
 
   ```console
   dotnet add package Microsoft.AspNetCore.StaticFiles -s https://dotnet.myget.org/F/dotnet-core/api/v3/index.json
-  ```
+  ```

docs/core/tools/dotnet-add-reference.md

@@ -1,17 +1,21 @@
 ---
 title: dotnet-add reference 命令
 description: dotnet add reference 命令可便于添加项目间引用。
-ms.date: 12/04/2018
-ms.openlocfilehash: 8df9fa3c9469f74b27a9cb8120936f03532b016c
-ms.sourcegitcommit: e6ad58812807937b03f5c581a219dcd7d1726b1d
+ms.date: 04/24/2019
+ms.openlocfilehash: f33a379534dca88133babbb5ca78bca614e441c8
+ms.sourcegitcommit: 2701302a99cafbe0d86d53d540eb0fa7e9b46b36
 ms.translationtype: HT
 ms.contentlocale: zh-CN
-ms.lasthandoff: 12/10/2018
-ms.locfileid: "53169753"
+ms.lasthandoff: 04/28/2019
+ms.locfileid: "64755192"
 ---
 # <a name="dotnet-add-reference"></a>dotnet-add reference
 
+**本文适用于：✓** .NET Core 1.x SDK 及更高版本
+
+<!-- todo: uncomment when all CLI commands are reviewed
 [!INCLUDE [topic-appliesto-net-core-all](../../../includes/topic-appliesto-net-core-all.md)]
+-->
 
 ## <a name="name"></a>name