Set ms.topic to how-to (#23970)

Author: gewarren

docfx.json

@@ -205,7 +205,7 @@
         "docs/csharp/roslyn-sdk/tutorials/*.md" : "tutorial",
         "docs/csharp/tour-of-csharp/tutorials/**" : "tutorial",
         "docs/csharp/tutorials/**" : "tutorial",
-        "docs/framework/**/*how-to*.md": "how-to",
+        "docs/framework/**/how-to*.md": "how-to",
         "docs/framework/additional-apis/**/**.md": "managed-reference",
         "docs/framework/unmanaged-api/**/**.md": "reference",
         "docs/framework/wcf/diagnostics/etw/**.md": "reference",

docs/framework/app-domains/build-multifile-assembly.md

@@ -2,6 +2,7 @@
 title: "How to: Build a multifile assembly"
 description: Learn how to build (create) a multifile assembly in .NET using sample code to illustrate each step in the procedure.
 ms.date: "08/20/2019"
+ms.topic: how-to
 helpviewer_keywords:
   - "assemblies [.NET Framework], multifile"
   - "entry point for assembly"

docs/framework/app-domains/build-single-file-assembly.md

@@ -2,6 +2,7 @@
 title: "How to: Build a .NET Framework single-file assembly"
 description: Explore how to build a single-file assembly in .NET. A single-file assembly can be a library (.dll) that targets .NET, or it can be an executable (.exe) file.
 ms.date: "08/20/2019"
+ms.topic: how-to
 helpviewer_keywords:
   - "assembly manifest, single-file assemblies"
   - "library assemblies"

docs/framework/app-domains/install-assembly-into-gac.md

@@ -2,6 +2,7 @@
 title: "How to: Install an assembly into the global assembly cache"
 description: Install an assembly into the global assembly cache (GAC) in .NET so it can be shared by many applications. Use Windows Installer or the GAC utility.
 ms.date: 08/20/2019
+ms.topic: how-to
 helpviewer_keywords:
   - "assemblies [.NET Framework], global assembly cache"
   - "Gacutil.exe"

docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md

@@ -2,25 +2,26 @@
 description: "Learn more about: How to: Implement CopyToDataTable<T> Where the Generic Type T Is Not a DataRow"
 title: "How to: Implement CopyToDataTable<T> Where the Generic Type T Is Not a DataRow"
 ms.date: "03/30/2017"
-dev_langs: 
+ms.topic: how-to
+dev_langs:
   - "csharp"
   - "vb"
 ms.assetid: b27b52cf-6172-485f-a75c-70ff9c5a2bd4
 ---
 # How to: Implement CopyToDataTable\<T> Where the Generic Type T Is Not a DataRow
 
-The <xref:System.Data.DataTable> object is often used for data binding. The <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> method takes the results of a query and copies the data into a <xref:System.Data.DataTable>, which can then be used for data binding. The <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> methods, however, only operate on an <xref:System.Collections.Generic.IEnumerable%601> source where the generic parameter `T` is of type <xref:System.Data.DataRow>. Although this is useful, it does not allow tables to be created from a sequence of scalar types, from queries that project anonymous types, or from queries that perform table joins.  
-  
- This topic describes how to implement two custom `CopyToDataTable<T>` extension methods that accept a generic parameter `T` of a type other than <xref:System.Data.DataRow>. The logic to create a <xref:System.Data.DataTable> from an <xref:System.Collections.Generic.IEnumerable%601> source is contained in the `ObjectShredder<T>` class, which is then wrapped in two overloaded `CopyToDataTable<T>` extension methods. The `Shred` method of the `ObjectShredder<T>` class returns the filled <xref:System.Data.DataTable> and accepts three input parameters: an <xref:System.Collections.Generic.IEnumerable%601> source, a <xref:System.Data.DataTable>, and a <xref:System.Data.LoadOption> enumeration. The initial schema of the returned <xref:System.Data.DataTable> is based on the schema of the type `T`. If an existing table is provided as input, the schema must be consistent with the schema of the type `T`. Each public property and field of the type `T` is converted to a <xref:System.Data.DataColumn> in the returned table. If the source sequence contains a type derived from `T`, the returned table schema is expanded for any additional public properties or fields.  
-  
- For examples of using the custom `CopyToDataTable<T>` methods, see [Creating a DataTable From a Query](creating-a-datatable-from-a-query-linq-to-dataset.md).  
-  
-### To implement the custom CopyToDataTable\<T> methods in your application  
-  
-1. Implement the `ObjectShredder<T>` class to create a <xref:System.Data.DataTable> from an <xref:System.Collections.Generic.IEnumerable%601> source:  
-  
+The <xref:System.Data.DataTable> object is often used for data binding. The <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> method takes the results of a query and copies the data into a <xref:System.Data.DataTable>, which can then be used for data binding. The <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> methods, however, only operate on an <xref:System.Collections.Generic.IEnumerable%601> source where the generic parameter `T` is of type <xref:System.Data.DataRow>. Although this is useful, it does not allow tables to be created from a sequence of scalar types, from queries that project anonymous types, or from queries that perform table joins.
+
+ This topic describes how to implement two custom `CopyToDataTable<T>` extension methods that accept a generic parameter `T` of a type other than <xref:System.Data.DataRow>. The logic to create a <xref:System.Data.DataTable> from an <xref:System.Collections.Generic.IEnumerable%601> source is contained in the `ObjectShredder<T>` class, which is then wrapped in two overloaded `CopyToDataTable<T>` extension methods. The `Shred` method of the `ObjectShredder<T>` class returns the filled <xref:System.Data.DataTable> and accepts three input parameters: an <xref:System.Collections.Generic.IEnumerable%601> source, a <xref:System.Data.DataTable>, and a <xref:System.Data.LoadOption> enumeration. The initial schema of the returned <xref:System.Data.DataTable> is based on the schema of the type `T`. If an existing table is provided as input, the schema must be consistent with the schema of the type `T`. Each public property and field of the type `T` is converted to a <xref:System.Data.DataColumn> in the returned table. If the source sequence contains a type derived from `T`, the returned table schema is expanded for any additional public properties or fields.
+
+ For examples of using the custom `CopyToDataTable<T>` methods, see [Creating a DataTable From a Query](creating-a-datatable-from-a-query-linq-to-dataset.md).
+
+### To implement the custom CopyToDataTable\<T> methods in your application
+
+1. Implement the `ObjectShredder<T>` class to create a <xref:System.Data.DataTable> from an <xref:System.Collections.Generic.IEnumerable%601> source:
+
      [!code-csharp[DP Custom CopyToDataTable Examples#ObjectShredderClass](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#objectshredderclass)]
-     [!code-vb[DP Custom CopyToDataTable Examples#ObjectShredderClass](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#objectshredderclass)]  
+     [!code-vb[DP Custom CopyToDataTable Examples#ObjectShredderClass](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#objectshredderclass)]
 
     The preceding example assumes that the properties and fields of the `DataColumn` are not nullable value types. To handle properties and fields with nullable value types, use the following code:
 
@@ -32,47 +33,47 @@ The <xref:System.Data.DataTable> object is often used for data binding. The <xre
     DataColumn dc = table.Columns.Contains(f.Name) ? table.Columns[f.Name] : table.Columns.Add(f.Name, Nullable.GetUnderlyingType(f.FieldType) ?? f.FieldType);
     ```
 
-2. Implement the custom `CopyToDataTable<T>` extension methods in a class:  
-  
+2. Implement the custom `CopyToDataTable<T>` extension methods in a class:
+
      [!code-csharp[DP Custom CopyToDataTable Examples#CustomCopyToDataTableMethods](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#customcopytodatatablemethods)]
-     [!code-vb[DP Custom CopyToDataTable Examples#CustomCopyToDataTableMethods](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#customcopytodatatablemethods)]  
-  
-3. Add the `ObjectShredder<T>` class and `CopyToDataTable<T>` extension methods to your application.  
-  
-```vb  
-Module Module1  
-    Sub Main()  
-        ' Your application code using CopyToDataTable<T>.  
-    End Sub  
-End Module  
-  
-Public Module CustomLINQtoDataSetMethods  
-…  
-End Module  
-  
-Public Class ObjectShredder(Of T)  
-…  
+     [!code-vb[DP Custom CopyToDataTable Examples#CustomCopyToDataTableMethods](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#customcopytodatatablemethods)]
+
+3. Add the `ObjectShredder<T>` class and `CopyToDataTable<T>` extension methods to your application.
+
+```vb
+Module Module1
+    Sub Main()
+        ' Your application code using CopyToDataTable<T>.
+    End Sub
+End Module
+
+Public Module CustomLINQtoDataSetMethods
+…
+End Module
+
+Public Class ObjectShredder(Of T)
+…
 End Class
 ```
-  
+
 ```csharp
-class Program  
-{  
-    static void Main(string[] args)  
-    {  
-        // Your application code using CopyToDataTable<T>.  
-    }  
-}  
-public static class CustomLINQtoDataSetMethods  
-{  
-…  
-}  
-public class ObjectShredder<T>  
-{  
-…  
-}  
+class Program
+{
+    static void Main(string[] args)
+    {
+        // Your application code using CopyToDataTable<T>.
+    }
+}
+public static class CustomLINQtoDataSetMethods
+{
+…
+}
+public class ObjectShredder<T>
+{
+…
+}
 ```
-  
+
 ## See also
 
 - [Creating a DataTable From a Query](creating-a-datatable-from-a-query-linq-to-dataset.md)

docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md

@@ -2,28 +2,29 @@
 description: "Learn more about: How to: Attach an Existing Entity to the DataServiceContext (WCF Data Services)"
 title: "How to: Attach an Existing Entity to the DataServiceContext (WCF Data Services)"
 ms.date: "03/30/2017"
-dev_langs: 
+ms.topic: how-to
+dev_langs:
   - "csharp"
   - "vb"
-helpviewer_keywords: 
+helpviewer_keywords:
   - "WCF Data Services, changing data"
 ms.assetid: e3f2d71d-434c-4e98-91c3-95adae4702b6
 ---
 # How to: Attach an Existing Entity to the DataServiceContext (WCF Data Services)
 
 [!INCLUDE [wcf-deprecated](~/includes/wcf-deprecated.md)]
 
-When an entity already exists in a data service, the WCF Data Services client library enables you to attach an object that represents the entity directly to the <xref:System.Data.Services.Client.DataServiceContext> without first executing a query. For more information, see [Updating the Data Service](updating-the-data-service-wcf-data-services.md).  
-  
- The example in this topic uses the Northwind sample data service and autogenerated client data service classes. This service and the client data classes are created when you complete the [WCF Data Services quickstart](quickstart-wcf-data-services.md).  
-  
-## Example  
+When an entity already exists in a data service, the WCF Data Services client library enables you to attach an object that represents the entity directly to the <xref:System.Data.Services.Client.DataServiceContext> without first executing a query. For more information, see [Updating the Data Service](updating-the-data-service-wcf-data-services.md).
+
+ The example in this topic uses the Northwind sample data service and autogenerated client data service classes. This service and the client data classes are created when you complete the [WCF Data Services quickstart](quickstart-wcf-data-services.md).
+
+## Example
+
+ The following example shows how to create an existing `Customer` object that contains changes to be saved to the data service. The object is attached to the context and the <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> method is called to mark the attached object as <xref:System.Data.Services.Client.EntityStates.Modified> before the <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> method is called.
 
- The following example shows how to create an existing `Customer` object that contains changes to be saved to the data service. The object is attached to the context and the <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> method is called to mark the attached object as <xref:System.Data.Services.Client.EntityStates.Modified> before the <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> method is called.  
-  
  [!code-csharp[Astoria Northwind Client#AttachObject](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria_northwind_client/cs/source.cs#attachobject)]
- [!code-vb[Astoria Northwind Client#AttachObject](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/source.vb#attachobject)]  
-  
+ [!code-vb[Astoria Northwind Client#AttachObject](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/source.vb#attachobject)]
+
 ## See also
 
 - [WCF Data Services Client Library](wcf-data-services-client-library.md)

docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md

@@ -2,10 +2,11 @@
 description: "Learn more about: How to: Bind Data to Windows Presentation Foundation Elements (WCF Data Services)"
 title: "How to: Bind Data to Windows Presentation Foundation Elements (WCF Data Services)"
 ms.date: "03/30/2017"
-dev_langs: 
+ms.topic: how-to
+dev_langs:
   - "csharp"
   - "vb"
-helpviewer_keywords: 
+helpviewer_keywords:
   - "data binding, WCF Data Services"
   - "WCF Data Services, data binding"
 ms.assetid: d6538ab0-0abe-426a-b9d9-e6f3a5ca2016
@@ -14,32 +15,32 @@ ms.assetid: d6538ab0-0abe-426a-b9d9-e6f3a5ca2016
 
 [!INCLUDE [wcf-deprecated](~/includes/wcf-deprecated.md)]
 
-With WCF Data Services, you can bind Windows Presentation Foundation (WPF) elements such as a <xref:System.Windows.Controls.ListBox> or <xref:System.Windows.Controls.ComboBox> to an instance of <xref:System.Data.Services.Client.DataServiceCollection%601>, which handles the events raised by the controls to keep the <xref:System.Data.Services.Client.DataServiceContext> synchronized with changes made to data in the controls. For more information, see [Binding Data to Controls](binding-data-to-controls-wcf-data-services.md).  
-  
- The example in this topic uses the Northwind sample data service and autogenerated client data service classes. This service and the client data classes are created when you complete the [WCF Data Services quickstart](quickstart-wcf-data-services.md).  
-  
-## Example  
+With WCF Data Services, you can bind Windows Presentation Foundation (WPF) elements such as a <xref:System.Windows.Controls.ListBox> or <xref:System.Windows.Controls.ComboBox> to an instance of <xref:System.Data.Services.Client.DataServiceCollection%601>, which handles the events raised by the controls to keep the <xref:System.Data.Services.Client.DataServiceContext> synchronized with changes made to data in the controls. For more information, see [Binding Data to Controls](binding-data-to-controls-wcf-data-services.md).
+
+ The example in this topic uses the Northwind sample data service and autogenerated client data service classes. This service and the client data classes are created when you complete the [WCF Data Services quickstart](quickstart-wcf-data-services.md).
+
+## Example
+
+ The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers, filtered by country/region. All of the pages of this paged result are loaded, along with the related orders, and are bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window. For more information, see [Loading Deferred Content](loading-deferred-content-wcf-data-services.md).
 
- The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers, filtered by country/region. All of the pages of this paged result are loaded, along with the related orders, and are bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window. For more information, see [Loading Deferred Content](loading-deferred-content-wcf-data-services.md).  
-  
  [!code-csharp[Astoria Northwind Client#BindPagedData](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria_northwind_client/cs/customerorderswpf3.xaml.cs#bindpageddata)]
- [!code-vb[Astoria Northwind Client#BindPagedData](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf3.xaml.vb#bindpageddata)]  
-  
-## Example  
-
- The following XAML defines the `SalesOrders` window in WPF for the previous example.  
-  
- [!code-xaml[Astoria Northwind Client#BindPagedDataXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf3.xaml#bindpageddataxaml)]  
-  
-## Example  
-
- The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers with related objects, filtered by country/region. This result is bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window.  
-  
+ [!code-vb[Astoria Northwind Client#BindPagedData](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf3.xaml.vb#bindpageddata)]
+
+## Example
+
+ The following XAML defines the `SalesOrders` window in WPF for the previous example.
+
+ [!code-xaml[Astoria Northwind Client#BindPagedDataXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf3.xaml#bindpageddataxaml)]
+
+## Example
+
+ The following example is from the code-behind page for an Extensible Application Markup Language (XAML) page that defines the `SalesOrders` window in WPF. When the window is loaded, a <xref:System.Data.Services.Client.DataServiceCollection%601> is created based on the result of a query that returns customers with related objects, filtered by country/region. This result is bound to the <xref:System.Windows.FrameworkElement.DataContext%2A> property of the <xref:System.Windows.Controls.StackPanel> that is the root layout control for the WPF window.
+
  [!code-csharp[Astoria Northwind Client#WpfDataBinding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria_northwind_client/cs/customerorderswpf.xaml.cs#wpfdatabinding)]
- [!code-vb[Astoria Northwind Client#WpfDataBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf.xaml.vb#wpfdatabinding)]  
-  
-## Example  
+ [!code-vb[Astoria Northwind Client#WpfDataBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf.xaml.vb#wpfdatabinding)]
+
+## Example
+
+ The following XAML defines the `SalesOrders` window in WPF for the previous example.
 
- The following XAML defines the `SalesOrders` window in WPF for the previous example.  
-  
  [!code-xaml[Astoria Northwind Client#WpfDataBindingXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria_northwind_client/vb/customerorderswpf.xaml#wpfdatabindingxaml)]

docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md

@@ -2,6 +2,7 @@
 description: "Learn more about: How to: Create a Data Service Using an ADO.NET Entity Framework Data Source (WCF Data Services)"
 title: "How to: Create a Data Service Using an ADO.NET Entity Framework Data Source (WCF Data Services)"
 ms.date: 08/24/2018
+ms.topic: how-to
 helpviewer_keywords:
   - "WCF Data Services, providers"
   - "WCF Data Services, Entity Framework"