Port documentation for .NET 7.0 Preview3 (#8004)

* Microsoft.Extensions.Hosting

* System (Numerics)

* System.CommandLine

* System.CommandLine.Binding

* System.CommandLine.Help

* System.CommandLine.IO

* System.CommandLine.Parsing

* System.Composition.Hosting

* System.Data.Common

* System.Diagnostics

* System.Runtime.CompilerServices

* System.Runtime.InteropServices

* System.Security.Cryptography.X509Certificates

* System.Text.RegularExpressions

* System.Threading.Tasks

* System.Web.DynamicData

* Fix code example

* Address Host.xml comments

* Fix HostApplicationBuilder table

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>

Author: carlossanlop

xml/Microsoft.Extensions.Hosting/Host.xml

@@ -18,7 +18,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Provides convenience methods for creating instances of <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder" /> with pre-configured defaults.</summary>
+    <summary>Provides convenience methods for creating instances of <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder" /> with preconfigured defaults.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -39,9 +39,21 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostApplicationBuilder" /> class with preconfigured defaults.</summary>
+        <returns>A new <see cref="T:Microsoft.Extensions.Hosting.HostApplicationBuilder" /> instance.</returns>
+        <remarks>The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
+<list type="bullet">
+  <item><description>Set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath"/> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory"/>.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from "DOTNET_" prefixed environment variables.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from supplied command line arguments.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/>].json'.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/> is 'Development' using the entry assembly.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from environment variables.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from supplied command line arguments.</description></item>
+  <item><description>Configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory"/> to log to the console, debug, and event source output.</description></item>
+  <item><description>Enable scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/> is 'Development'.</description></item>
+</list>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CreateApplicationBuilder">
@@ -63,10 +75,23 @@
         <Parameter Name="args" Type="System.String[]" Index="0" FrameworkAlternate="dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="args">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="args">The command line arguments.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostApplicationBuilder" /> class with preconfigured defaults.</summary>
+        <returns>A new <see cref="T:Microsoft.Extensions.Hosting.HostApplicationBuilder" /> instance.</returns>
+        <remarks>
+The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
+<list type="bullet">
+  <item><description>Set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath"/> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory"/>.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from "DOTNET_" prefixed environment variables.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from supplied command line arguments.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/>].json'.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/> is 'Development' using the entry assembly.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from environment variables.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> from supplied command line arguments.</description></item>
+  <item><description>Configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory"/> to log to the console, debug, and event source output.</description></item>
+  <item><description>Enable scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName"/> is 'Development'.</description></item>
+</list>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultBuilder">
@@ -90,11 +115,19 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" /> class with pre-configured defaults.</summary>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" /> class with preconfigured defaults.</summary>
         <returns>The initialized <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder" />.</returns>
-        <remarks>
-              The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
-              <list type="bullet"><item><description>set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath" /> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory" /></description></item><item><description>load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from "DOTNET_" prefixed environment variables</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" />].json'</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development' using the entry assembly</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from environment variables</description></item><item><description>configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> to log to the console, debug, and event source output</description></item><item><description>enables scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development'</description></item></list></remarks>
+        <remarks>The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
+<list type="bullet">
+  <item><description>Set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath" /> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory" />.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from "DOTNET_" prefixed environment variables.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" />].json'.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development' using the entry assembly.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from environment variables.</description></item>
+  <item><description>Configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> to log to the console, debug, and event source output.</description></item>
+  <item><description>Enable scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development'.</description></item>
+</list>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultBuilder">
@@ -120,12 +153,22 @@
         <Parameter Name="args" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <param name="args">The command line args.</param>
-        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" /> class with pre-configured defaults.</summary>
+        <param name="args">The command line arguments.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" /> class with preconfigured defaults.</summary>
         <returns>The initialized <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder" />.</returns>
-        <remarks>
-              The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
-              <list type="bullet"><item><description>set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath" /> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory" /></description></item><item><description>load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from "DOTNET_" prefixed environment variables</description></item><item><description>load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from supplied command line args</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" />].json'</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development' using the entry assembly</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from environment variables</description></item><item><description>load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from supplied command line args</description></item><item><description>configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> to log to the console, debug, and event source output</description></item><item><description>enables scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development'</description></item></list></remarks>
+        <remarks>The following defaults are applied to the returned <see cref="T:Microsoft.Extensions.Hosting.HostBuilder" />:
+<list type="bullet">
+  <item><description>Set the <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.ContentRootPath" /> to the result of <see cref="M:System.IO.Directory.GetCurrentDirectory" />.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from "DOTNET_" prefixed environment variables.</description></item>
+  <item><description>Load host <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from supplied command line arguments.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from 'appsettings.json' and 'appsettings.[<see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" />].json'.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from User Secrets when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development' using the entry assembly.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from environment variables.</description></item>
+  <item><description>Load app <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> from supplied command line arguments.</description></item>
+  <item><description>Configure the <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> to log to the console, debug, and event source output.</description></item>
+  <item><description>Enable scope validation on the dependency injection container when <see cref="P:Microsoft.Extensions.Hosting.IHostEnvironment.EnvironmentName" /> is 'Development'.</description></item>
+</list>
+        </remarks>
       </Docs>
     </Member>
   </Members>