Merge pull request #4741 from MicrosoftDocs/master

5/30/2019 AM Publish

Author: Taojunshen

docs/code-quality/ca2214-do-not-call-overridable-methods-in-constructors.md

@@ -1,6 +1,6 @@
 ---
 title: "CA2214: Do not call overridable methods in constructors"
-ms.date: 11/04/2016
+ms.date: 05/29/2016
 ms.topic: reference
 f1_keywords:
   - "DoNotCallOverridableMethodsInConstructors"
@@ -33,7 +33,10 @@ The constructor of an unsealed type calls a virtual method defined in its class.
 
 ## Rule description
 
-When a virtual method is called, the actual type that executes the method is not selected until run time. When a constructor calls a virtual method, it is possible that the constructor for the instance that invokes the method has not executed.
+When a virtual method is called, the actual type that executes the method is not selected until run time. When a constructor calls a virtual method, it's possible that the constructor for the instance that invokes the method has not executed.
+
+> [!NOTE]
+> The binary analysis implementation of this rule has a different diagnostic message of "**\[Constructor name] contains a call chain that results in a call to a virtual method defined by the class. Review the following call stack for unintended consequences**". The [FxCop analyzers](install-fxcop-analyzers.md) implementation of this rule has a diagnostic message of "**Do not call overridable methods in constructors**".
 
 ## How to fix violations
 
@@ -45,7 +48,7 @@ Do not suppress a warning from this rule. The constructor should be redesigned t
 
 ## Example
 
-The following example demonstrates the effect of violating this rule. The test application creates an instance of `DerivedType`, which causes its base class (`BadlyConstructedType`) constructor to execute. `BadlyConstructedType`'s constructor incorrectly calls the virtual method `DoSomething`. As the output shows, `DerivedType.DoSomething()` executes, and does so before `DerivedType`'s constructor executes.
+The following example demonstrates the effect of violating this rule. The test application creates an instance of `DerivedType`, which causes its base class (`BadlyConstructedType`) constructor to execute. `BadlyConstructedType`'s constructor incorrectly calls the virtual method `DoSomething`. As the output shows, `DerivedType.DoSomething()` executes before `DerivedType`'s constructor executes.
 
 [!code-csharp[FxCop.Usage.CtorVirtual#1](../code-quality/codesnippet/CSharp/ca2214-do-not-call-overridable-methods-in-constructors_1.cs)]
 [!code-vb[FxCop.Usage.CtorVirtual#1](../code-quality/codesnippet/VisualBasic/ca2214-do-not-call-overridable-methods-in-constructors_1.vb)]

docs/get-started/csharp/media/vs-2019/vs2019-choose-aspnetcore-project.png

@@ -106,6 +106,9 @@ public void OnGet()
 
 You should now see the actual server time in the browser when you navigate to the app.
 
+> [!NOTE]
+> Your output might differ from the image, since the output format of ToShortDateTimeString depends on the current culture setting. See <xref:System.DateTime.ToShortTimeString>.
+
 ![Visual Studio 2019 ASP.NET Core Project in Browser](media/vs-2019/vs2019-app-fixed-in-browser.png)
 
 ## Next steps

docs/get-started/csharp/tutorial-aspnet-core-ef-step-02.md

@@ -3,7 +3,7 @@ title: "Tutorial: Get started with C# and ASP.NET Core"
 titleSuffix: ""
 description: "Learn how to create an ASP.NET Core web app in Visual Studio with C#, step-by-step."
 ms.custom: "seodec18, get-started"
-ms.date: 03/23/2019
+ms.date: 05/29/2019
 ms.technology: vs-ide-general
 ms.prod: visual-studio-windows
 ms.topic: tutorial
@@ -39,7 +39,7 @@ If you haven't already installed Visual Studio, go to the [Visual Studio downloa
 
 ### Update Visual Studio
 
-If you've already installed Visual Studio, make sure that you are running the most recent release. For more information about how to update your installation, see the [Update Visual Studio to the most recent release](../../install/update-visual-studio.md) page.
+If you've already installed Visual Studio, make sure that you're running the most recent release. For more information about how to update your installation, see the [Update Visual Studio to the most recent release](../../install/update-visual-studio.md) page.
 
 ### Choose your theme (optional)
 
@@ -92,7 +92,7 @@ If you don't see the **ASP.NET Core Web Application** project template, you can
    ![New ASP.NET Core Web Application dialog box](media/new-project-csharp-aspnet-razor-web-app.png)
 
    > [!NOTE]
-   > If you don't see **ASP.NET Core 2.1** or later from the top drop-down menu, make sure that you are running the most recent release of Visual Studio. For more information about how to update your installation, see the [Update Visual Studio to the most recent release](../../install/update-visual-studio.md) page.
+   > If you don't see **ASP.NET Core 2.1** from the top drop-down menu, make sure that you are running the most recent release of Visual Studio. For more information about how to update your installation, see the [Update Visual Studio to the most recent release](../../install/update-visual-studio.md) page.
 
 ::: moniker-end
 
@@ -102,28 +102,28 @@ If you don't see the **ASP.NET Core Web Application** project template, you can
 
    ![View the 'Create a new project' window](../../get-started/media/vs-2019/create-new-project-dark-theme.png)
 
-1. On the **Create a new project** window, enter or type *ASP.NET* in the search box. Next, choose **C#** from the Language list, and then choose **Windows** from the Platform list. 
+1. On the **Create a new project** window, enter or type *ASP.NET* in the search box. Next, choose **C#** from the Language list, and then choose **Windows** from the Platform list.
 
    After you apply the language and platform filters, choose the **ASP.NET Core Web Application** template, and then choose **Next**.
 
    ![Choose the C# template for the ASP.NET Core Web Application](./media/vs-2019/csharp-create-new-project-search-aspnet-core-filtered.png)
 
    > [!NOTE]
-   > If you do not see the **ASP.NET Core Web Application** template, you can install it from the **Create a new project** window. In the **Not finding what you're looking for?** message, choose the **Install more tools and features** link.
+   > If you don't see the **ASP.NET Core Web Application** template, you can install it from the **Create a new project** window. In the **Not finding what you're looking for?** message, choose the **Install more tools and features** link.
+   >
+   > ![The 'Install more tools and features' link from the 'Not finding what you're looking for' message in the 'Create new project' window](../../get-started/media/vs-2019/not-finding-what-looking-for.png)
    >
-   > ![The 'Install more tools and features' link from the 'Not finding what you're looking for' message in the 'Create new project' window](../../get-started/media/vs-2019/not-finding-what-looking-for.png) 
-   > 
    > Then, in the Visual Studio Installer, choose the **ASP.NET and web development** workload.
    >
    > ![.NET Core cross-platform development workload in the Visual Studio Installer](../../get-started/media/aspnet-core-web-dev-workload.png)
    >
-   > After that, choose the **Modify** button in the Visual Studio Installer. You might be prompted to save your work; if so, do so. Next, choose **Continue** to install the workload. Then, return to step 2 in this "[Create a project](#create-a-project)" procedure.
+   > After that, choose the **Modify** button in the Visual Studio Installer. If you're prompted to save your work, do so. Next, choose **Continue** to install the workload. Then, return to step 2 in this "[Create a project](#create-a-project)" procedure.
 
 1. In the **Configure your new project** window, type or enter *MyCoreApp* in the **Project name** box. Then, choose **Create**.
 
    ![in the 'Configure your new project' window, name your project 'MyCoreApp'](./media/vs-2019/csharp-name-your-aspnet-mycoreapp-project.png)
 
-1. In the **Create a new ASP.NET Core Web Application** window, verify that **ASP.NET Core 2.1** or later appears in the top drop-down menu. Then, choose **Web Application**, which includes example Razor Pages. Next, choose  **Create**.
+1. In the **Create a new ASP.NET Core Web Application** window, verify that **ASP.NET Core 2.1** appears in the top drop-down menu. Then, choose **Web Application**, which includes example Razor Pages. Next, choose  **Create**.
 
    ![The 'Create a new ASP.NET Core Web Application' window](./media/vs-2019/csharp-create-aspnet-core-razor-pages-app.png)
 
@@ -133,7 +133,7 @@ If you don't see the **ASP.NET Core Web Application** project template, you can
 
 ### About your solution
 
-This solution follows the **Razor Page** design pattern. It is different than the [Model-View-Controller (MVC)](/aspnet/core/tutorials/first-mvc-app/start-mvc?view=aspnetcore-2.1&tabs=aspnetcore2x) design pattern in that its streamlined to include the model and controller code within the Razor Page itself.
+This solution follows the **Razor Page** design pattern. It's different than the [Model-View-Controller (MVC)](/aspnet/core/tutorials/first-mvc-app/start-mvc?view=aspnetcore-2.1&tabs=aspnetcore2x) design pattern in that it's streamlined to include the model and controller code within the Razor Page itself.
 
 ## Tour your solution
 
@@ -176,15 +176,12 @@ This solution follows the **Razor Page** design pattern. It is different than th
      > [!NOTE]
      > If you get an error message that says **Unable to connect to web server 'IIS Express'**, close Visual Studio and then open it by using the **Run as administrator** option from the right-click or context menu. Then, run the application again.
      >
-     > You might also get a message that asks if you want to accept an IIS SSL Express certificate. To view the code in a web browser, choose **Yes**, and then choose **Yes** if you receive a follow-up security warning message. 
+     > You might also get a message that asks if you want to accept an IIS SSL Express certificate. To view the code in a web browser, choose **Yes**, and then choose **Yes** if you receive a follow-up security warning message.
 
-1. Visual Studio launches a browser window. You should then see **Home**, **About**, and **Contact** pages in the menu bar. (If you do not, choose the "hamburger" menu item to view them.)
+1. Visual Studio launches a browser window. You should then see **Home**, **About**, and **Contact** pages in the menu bar. (If you don't, choose the "hamburger" menu item to view them.)
 
     ![Select the "hamburger" menu item from the menu bar in your web app](media/csharp-aspnet-razor-browser-page.png)
 
-     > [!TIP]
-     > You cannot edit code in the Visual Studio code editor when your project is open in a browser window. 
-
 1. Choose **About** from the menu bar.
 
    ![Select About in the browser window's menu bar for your app](media/csharp-aspnet-razor-browser-page-about-menu.png)
@@ -193,7 +190,7 @@ This solution follows the **Razor Page** design pattern. It is different than th
 
    ![View the text on the About page](media/csharp-aspnet-razor-browser-page-about.png)
 
-1. Keep the browser window open and return to Visual Studio.
+1. Return to Visual Studio, and then press **Shift+F5** to stop Debug mode. This also closes the project in the browser window.
 
 1. In Visual Studio, choose **About.cshtml**. Then, delete the word _additional_ and in its place, add the words _file and directory_.
 
@@ -217,7 +214,7 @@ This solution follows the **Razor Page** design pattern. It is different than th
      }
     ```
 
-1. Notice that two wavy underlines appear under **Environment** and **String**. The wavy underlines appear because these types are not in scope.
+1. Notice that two wavy underlines appear under **Environment** and **String**. The wavy underlines appear because these types aren't in scope.
 
    ![Errors marked with wavy underlines in OnGet method](media/csharp-aspnet-razor-add-new-on-get-method.png)
 
@@ -229,7 +226,7 @@ This solution follows the **Razor Page** design pattern. It is different than th
 
    ![Add the "using System;" directive](media/csharp-aspnet-razor-add-usings.png)
 
-1. Press **Ctrl**+**S** to save your changes and refresh your app in the web browser.
+1. Press **Ctrl**+**S** to save your changes, and then press **F5** to open your project in the web browser.
 
 1. At the top of the web site, choose **About** to view your changes.
 

docs/get-started/csharp/tutorial-aspnet-core.md

@@ -173,7 +173,7 @@ If you're ready to code with Visual Studio, dive into any of the following langu
 
 - [Visual Studio tutorials | **C#**](./csharp/index.yml)
 - [Visual Studio tutorials | **Visual Basic**](./visual-basic/index.yml)
-- [Visual Studio tutorials | **C++**](/cpp/get-started/)
+- [Visual Studio tutorials | **C++**](/cpp/get-started/tutorial-console-cpp)
 - [Visual Studio tutorials | **Python**](/visualstudio/python/)
 - [Visual Studio tutorials | **JavaScript**, **TypeScript**, and **Node.js**](/visualstudio/javascript/)
 

docs/get-started/tutorial-open-project-from-repo.md

@@ -373,7 +373,7 @@ The sections in the following table include commands that are global in that you
 |View.ObjectBrowser|**Ctrl+Alt+J**|
 |View.ObjectBrowserGoToSearchCombo|**Ctrl+K, Ctrl+R**|
 |View.Output|**Ctrl+Alt+O** (letter 'O')|
-|View.PopBrowseContex|**Ctrl+Shift+8**|
+|View.PopBrowseContext|**Ctrl+Shift+8** (C++ only)|
 |View.PropertiesWindow|**F4**|
 |View.PropertyPages|**Shift+F4**|
 |View.ResourceView|**Ctrl+Shift+E**|

docs/ide/default-keyboard-shortcuts-in-visual-studio.md

@@ -64,7 +64,7 @@ sections:
     - image:
         src: https://docs.microsoft.com/media/logos/logo_cplusplus.svg
       text: C++
-      href: /cpp/get-started/
+      href: /cpp/get-started/tutorial-console-cpp
     - image:
         src: https://docs.microsoft.com/media/logos/logo_python.svg
       text: Python

docs/ide/index.yml

@@ -129,7 +129,7 @@ ms.custom: seodec18
                                                         </td>
                                                         <td style="border-top-color:transparent!important;padding-left:0;">
                                                             <ul class="noBullet">                                     <li>
-                                                                    <a class="barLink" href="/cpp/get-started/">
+                                                                    <a class="barLink" href="/cpp/get-started/tutorial-console-cpp">
                                                                         <img src="https://docs.microsoft.com/media/logos/logo_Cplusplus.svg" alt="C++ icon">
                                                                         C++
                                                                     </a>

docs/index.md

@@ -0,0 +1,37 @@
+---
+title: "When package payloads change after a release"
+description: "When creating a layout, learn how to determine if package payloads changed after a release has already shipped."
+ms.date: 05/22/2019
+ms.topic: conceptual
+author: et13
+ms.author: tglee
+manager: jillfra
+ms.workload:
+  - "multiple"
+ms.prod: visual-studio-windows
+ms.technology: vs-installation
+---
+# Package payload changes
+
+Some package payloads are allowed to change after a release has already shipped. When you or someone else creates a layout, this behavior might result in different layout content, depending on when a layout was created.
+
+## Verify that a layout includes package payload changes
+
+Here's how to determine if the layout that was previously created has acquired the package payloads that were modified after the release shipped:
+
+1. Open the setup log. The log is typically at `%TEMP%\dd_setup_[date].log` where `[date]` is when the layout operation started in `yyyyMMddHHmmss` format.
+
+2. Look for a line in the log that is structured like the following text:
+
+    `Falling back to signature and signer check because hash verification returned HashMismatch for path: [path]`
+
+3. Then, look for lines later in the log that indicate that the download succeeded for the [path]. They might look similar to the following text:
+
+    `Download of [url] succeeded using engine 'WebClient'`
+
+    `END: Downloading [url] to [path]`
+
+## See also
+
+* [Create a network installation of Visual Studio](create-a-network-installation-of-visual-studio.md)
+* [Update a networked-based installation of Visual Studio](update-a-network-installation-of-visual-studio.md)

docs/install/changed-payloads.md

@@ -1,5 +1,5 @@
 ---
-title: "Deploying, Publishing, and Upgrading SharePoint Solution Packages | Microsoft Docs"
+title: "Deploy, publish, & upgrade SharePoint solution packages"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 f1_keywords:

docs/sharepoint/deploying-publishing-and-upgrading-sharepoint-solution-packages.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Add a Property to a Custom SharePoint Project Item Type | Microsoft Docs"
+title: "Add property to custom SharePoint project item type"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-add-a-property-to-a-custom-sharepoint-project-item-type.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Add a Shortcut Menu Item to a Custom SharePoint Project Item Type | Microsoft Docs"
+title: "Add shortcut menu item to custom SharePoint project item type"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-add-a-shortcut-menu-item-to-a-custom-sharepoint-project-item-type.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Add a Shortcut Menu Item to a SharePoint Project Item Extension | Microsoft Docs"
+title: "Add shortcut menu item to SharePoint project item extension"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-add-a-shortcut-menu-item-to-a-sharepoint-project-item-extension.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Add and Remove Features and Items to a Package by Using the Package Designer | Microsoft Docs"
+title: "Package designer: Add & remove features and items to package"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 f1_keywords:

docs/sharepoint/how-to-add-and-remove-features-and-items-to-a-package-by-using-the-package-designer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Add and Remove Features and Items to a Package by Using the Packaging Explorer | Microsoft Docs"
+title: "Packaging Explorer: Add & remove features & items to package"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 f1_keywords:

docs/sharepoint/how-to-add-and-remove-features-and-items-to-a-package-by-using-the-packaging-explorer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Create a SharePoint Solution Package by Using MSBuild Tasks | Microsoft Docs"
+title: "Create SharePoint solution package using MSBuild tasks"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-create-a-sharepoint-solution-package-by-using-msbuild-tasks.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Create a User Control for a SharePoint Application Page or Web Part | Microsoft Docs"
+title: "Create user control for SharePoint app page or web part"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-create-a-user-control-for-a-sharepoint-application-page-or-web-part.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Customize a SharePoint Solution Package by Using MSBuild Targets | Microsoft Docs"
+title: "Customize SharePoint solution package using MSBuild targets"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-customize-a-sharepoint-solution-package-by-using-msbuild-targets.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Deploy and Publish a SharePoint Solution to a Local SharePoint Site | Microsoft Docs"
+title: "Deploy & publish SharePoint solution to local SharePoint site"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-deploy-and-publish-a-sharepoint-solution-to-a-local-sharepoint-site.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Deploy, Publish, and Upgrade SharePoint Solutions on a Remote Server | Microsoft Docs"
+title: "Deploy, publish, & upgrade SharePoint solutions remotely"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:
@@ -29,7 +29,7 @@ ms.workload:
 
 4. Choose the **Publish** button.
 
-5. Log on to the remote server if user authentication is required.
+5. Sign in to the remote server if user authentication is required.
 
      The publishing progress appears in the Visual Studio **Output** window. When the process is finished, the solution (*.wsp*) file is installed on the remote SharePoint server. However, it must still be activated before it can be used in SharePoint.
 
@@ -56,7 +56,7 @@ ms.workload:
 
 7. Choose the **Publish** button.
 
-8. Log on to the remote server if user authentication is required.
+8. Sign in to the remote server if user authentication is required.
 
      If you logged in to the remote server recently, authentication may not be required.
 

docs/sharepoint/how-to-deploy-publish-and-upgrade-sharepoint-solutions-on-a-remote-server.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Get Data for a Built-In SharePoint Node in Server Explorer | Microsoft Docs"
+title: "Get data for built-in SharePoint node in Server Explorer"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs:

docs/sharepoint/how-to-get-data-for-a-built-in-sharepoint-node-in-server-explorer.md

@@ -1,5 +1,5 @@
 ---
-title: "How to: Run Code When a SharePoint Project is Deployed or Retracted | Microsoft Docs"
+title: "Run code when SharePoint project is deployed or retracted"
 ms.date: "02/02/2017"
 ms.topic: "conceptual"
 dev_langs: