fix reference enum field - Part 4 (#3087)

* fix reference enum field

* Apply suggestions from doc review

Co-Authored-By: Ron Petrusha <[email protected]>

Author: mairaw

xml/System.Web.UI/CompilationMode.xml

@@ -19,18 +19,18 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.CompilationMode> enumeration values indicate whether a page or control should be compiled at run time. When no compilation mode is specified, the default value is Always. Setting a page to never compile using the Never attribute will increase performance by disqualifying the specified page in the compilation process. To define a page-specific <xref:System.Web.UI.CompilationMode.Always> attribute that specifies an .aspx, .ascx or .master file should not be compiled at the page level, you can use a directive like the following:  
+ The `CompilationMode` enumeration values indicate whether a page or control should be compiled at run time. When no compilation mode is specified, the default value is `Always`. Setting a page to never compile using the `Never` attribute increases performance by disqualifying the specified page in the compilation process. To define a page-specific `CompilationMode` attribute that specifies an .aspx, .ascx, or .master file should not be compiled at the page level, you can use a directive like the following:  
   
  `<%@ page compilationMode="never" %>`  
   
- The compilation mode can also be specified in configuration files. The <xref:System.Web.Configuration.PagesSection> configuration section object identifies page-specific configuration settings. The [pages](https://msdn.microsoft.com/library/4123bb66-3fe4-4d62-b70e-33758656b458) configuration section element can be declared at the machine, site, application, and subdirectory levels of the configuration files.  
+ The compilation mode can also be specified in configuration files. The <xref:System.Web.Configuration.PagesSection> configuration section object identifies page-specific configuration settings. The [pages](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/950xf363(v=vs.100)) configuration section element can be declared at the machine, site, application, and subdirectory levels of the configuration files.  
   
- If the <xref:System.Web.UI.CompilationMode> is set to Never and a page contains a script block or code construct that requires compilation, ASP.NET will return with an error and the page will not run.  
+ If the `CompilationMode` is set to `Never` and a page contains a script block or code construct that requires compilation, ASP.NET returns with an error and the page doesn't run.  
   
    
   
 ## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.CompilationMode> page directive to indicate that a page should never be compiled.  
+ The following example demonstrates how to use the `CompilationMode` page directive to indicate that a page should never be compiled.  
   
  [!code-aspx-csharp[CompilationMode#1](~/samples/snippets/csharp/VS_Snippets_WebNet/CompilationMode/CS/compilationmode_cs.aspx#1)]
  [!code-aspx-vb[CompilationMode#1](~/samples/snippets/visualbasic/VS_Snippets_WebNet/CompilationMode/VB/compilationmode_vb.aspx#1)]  

xml/System.Web.UI/DataSourceCacheExpiry.xml

@@ -19,19 +19,19 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.DataSourceCacheExpiry> enumeration describes how data cached by a data source control expires in the ASP.NET cache. An ASP.NET data source control caches data in the ASP.NET cache based on a specified time-out period, which is set using the `CacheDuration` property. The <xref:System.Web.UI.DataSourceCacheExpiry> describes how this time-out setting is used. If the expiration policy is set to Absolute, the cached data is discarded when the amount of time specified passes since the data was first cached. If the expiration policy is set to Sliding, the cached data is discarded only when the cache entry has not been used for the amount of time specified.  
+ The `DataSourceCacheExpiry` enumeration describes how data cached by a data source control expires in the ASP.NET cache. An ASP.NET data source control caches data in the ASP.NET cache based on a specified time-out period, which is set using the `CacheDuration` property. The `DataSourceCacheExpiry` describes how this time-out setting is used. If the expiration policy is set to `Absolute`, the cached data is discarded when the amount of time specified passes since the data was first cached. If the expiration policy is set to `Sliding`, the cached data is discarded only when the cache entry has not been used for the amount of time specified.  
   
    
   
 ## Examples  
- The following code example demonstrates how to use the <xref:System.Web.UI.DataSourceCacheExpiry.Absolute> enumeration declaratively. In this example, a <xref:System.Web.UI.WebControls.SqlDataSource> control is used to display data in a <xref:System.Web.UI.WebControls.GridView> control. The <xref:System.Web.UI.WebControls.SqlDataSource> control has caching enabled and its <xref:System.Web.UI.WebControls.SqlDataSource.CacheExpirationPolicy%2A> set to Sliding, to cache data as long as there is activity.  
+ The following example demonstrates how to use the `DataSourceCacheExpiry` enumeration declaratively. In this example, a <xref:System.Web.UI.WebControls.SqlDataSource> control is used to display data in a <xref:System.Web.UI.WebControls.GridView> control. The <xref:System.Web.UI.WebControls.SqlDataSource> control has caching enabled and its <xref:System.Web.UI.WebControls.SqlDataSource.CacheExpirationPolicy%2A> set to `Sliding` to cache data as long as there is activity.  
   
  [!code-aspx-csharp[System.Web.UI.WebControls.SqlDataSource_19sql#1](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.WebControls.SqlDataSource_19sql/CS/sql19cs.aspx#1)]
  [!code-aspx-vb[System.Web.UI.WebControls.SqlDataSource_19sql#1](~/samples/snippets/visualbasic/VS_Snippets_WebNet/System.Web.UI.WebControls.SqlDataSource_19sql/VB/sql19vb.aspx#1)]  
   
  ]]></format>
     </remarks>
-    <related type="Article" href="https://msdn.microsoft.com/library/ac11c8ea-df5d-4de8-b315-9ccf1048b0ce">ASP.NET Caching</related>
+    <related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/xsbfdd8c(v=vs.100)">ASP.NET Caching</related>
   </Docs>
   <Members>
     <Member MemberName="Absolute">
@@ -53,7 +53,7 @@
       <MemberValue>0</MemberValue>
       <Docs>
         <summary>Cached data expires when the amount of time specified by the <see langword="CacheDuration" /> property has passed since the data was first cached.</summary>
-        <related type="Article" href="https://msdn.microsoft.com/library/ac11c8ea-df5d-4de8-b315-9ccf1048b0ce">ASP.NET Caching</related>
+        <related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/xsbfdd8c(v=vs.100)">ASP.NET Caching</related>
       </Docs>
     </Member>
     <Member MemberName="Sliding">

xml/System.Web.UI/HtmlTextWriterTag.xml

@@ -20,12 +20,12 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This enumeration allows the output stream to write HTML mark up, along with HTML server controls, in response to a Web request.  
+ The `HtmlTextWriterTag` enumeration allows the output stream to write HTML markup, along with HTML server controls, in response to a web request.  
   
    
   
 ## Examples  
- The following example demonstrates the use of the <xref:System.Web.UI.HtmlTextWriterTag> enumeration. The Img field is used during rendering of an <xref:System.Web.UI.HtmlTextWriterTag.Img> named `writer`.  
+ The following example demonstrates the use of the `HtmlTextWriterTag` enumeration. The `Img` field is used during rendering of an <xref:System.Web.UI.HtmlTextWriter> named `writer`.  
   
  [!code-cpp[System.Web.UI.HtmlTextWriter#3](~/samples/snippets/cpp/VS_Snippets_WebNet/System.Web.UI.HtmlTextWriter/CPP/htmltextwriter.cpp#3)]
  [!code-csharp[System.Web.UI.HtmlTextWriter#3](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.HtmlTextWriter/CS/htmltextwriter.cs#3)]

xml/System.Web.UI/UpdatePanelRenderMode.xml

@@ -19,14 +19,14 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.UI.UpdatePanelRenderMode> enumeration defines which HTML elements to use to enclose the content of the <xref:System.Web.UI.UpdatePanel> control. The <xref:System.Web.UI.UpdatePanel.RenderMode%2A> property must be one of the values of the <xref:System.Web.UI.UpdatePanelRenderMode> enumeration. The content of an <xref:System.Web.UI.UpdatePanel> control can be rendered inside either an HTML `<div>` element or a `<span>` element.  
+ The `UpdatePanelRenderMode` enumeration defines which HTML elements to use to enclose the content of the <xref:System.Web.UI.UpdatePanel> control. The <xref:System.Web.UI.UpdatePanel.RenderMode%2A?displayProperty=nameWithType> property must be one of the values of the `UpdatePanelRenderMode` enumeration. The content of an <xref:System.Web.UI.UpdatePanel> control can be rendered inside either an HTML `<div>` element or a `<span>` element.  
   
- The default <xref:System.Web.UI.UpdatePanel.RenderMode%2A> property value is Block.  
+ The default <xref:System.Web.UI.UpdatePanel.RenderMode%2A> property value is `Block`.  
   
    
   
 ## Examples  
- The following example shows how to declaratively set the <xref:System.Web.UI.UpdatePanel.RenderMode%2A> property of an <xref:System.Web.UI.UpdatePanel.RenderMode%2A> control to Inline. The <xref:System.Web.UI.UpdatePanel> control contains a string that represents the number of postbacks from the page. The contents are rendered inline with the surrounding text.  
+ The following example shows how to declaratively set the <xref:System.Web.UI.UpdatePanel.RenderMode%2A?displayProperty=nameWithType> property to `Inline`. The <xref:System.Web.UI.UpdatePanel> control contains a string that represents the number of postbacks from the page. The contents are rendered inline with the surrounding text.  
   
  [!code-aspx-csharp[System.Web.UI.UpdatePanel.RenderMode#1](~/samples/snippets/csharp/VS_Snippets_Atlas/System.Web.UI.UpdatePanel.RenderMode/CS/UpdatePanelRenderModeCS.aspx#1)]
  [!code-aspx-vb[System.Web.UI.UpdatePanel.RenderMode#1](~/samples/snippets/visualbasic/VS_Snippets_Atlas/System.Web.UI.UpdatePanel.RenderMode/VB/UpdatePanelRenderModeVB.aspx#1)]  

xml/System.Web.UI/UpdatePanelUpdateMode.xml

@@ -35,7 +35,7 @@ The `Conditional` value updates the content of the <xref:System.Web.UI.UpdatePan
 - The <xref:System.Web.UI.UpdatePanel.ChildrenAsTriggers%2A?displayProperty=nameWithType> property is set to `true` and a child control of the <xref:System.Web.UI.UpdatePanel> control causes a postback. In this scenario, child controls of the <xref:System.Web.UI.UpdatePanel> control are implicit triggers for updating the panel. Child controls of nested <xref:System.Web.UI.UpdatePanel> controls do not cause the outer <xref:System.Web.UI.UpdatePanel> control to be updated unless they are explicitly defined as triggers. 
 
 ## Examples  
- The following example declares two <xref:System.Web.UI.UpdatePanel.UpdateMode%2A> controls. The first panel sets the <xref:System.Web.UI.UpdatePanel.UpdateMode%2A> property of an <xref:System.Web.UI.UpdatePanel.UpdateMode%2A> control to Conditional. The second panel has <xref:System.Web.UI.UpdatePanel.UpdateMode%2A> set to Always by default. A button outside both panels is registered as an asynchronous postback control by using the <xref:System.Web.UI.ScriptManager.RegisterAsyncPostBackControl%2A> method of the <xref:System.Web.UI.ScriptManager> control. In the button's click event handler, the <xref:System.Web.UI.UpdatePanel.Update%2A> method of the first panel is called if more than five seconds have elapsed since its last update. In this scenario, the panel's content is updated only if the last panel update was more than five seconds ago. The second panel's content is always updated.  
+ The following example declares two <xref:System.Web.UI.UpdatePanel> controls. The first panel sets the <xref:System.Web.UI.UpdatePanel.UpdateMode%2A?displayProperty=nameWithType> property to `Conditional`. The second panel has <xref:System.Web.UI.UpdatePanel.UpdateMode%2A?displayProperty=nameWithType> set to `Always` by default. A button outside both panels is registered as an asynchronous postback control by using the <xref:System.Web.UI.ScriptManager.RegisterAsyncPostBackControl%2A?displayProperty=nameWithType> method. In the button's click event handler, the <xref:System.Web.UI.UpdatePanel.Update%2A?displayProperty=nameWithType> method of the first panel is called if more than five seconds have elapsed since its last update. In this scenario, the panel's content is updated only if the last panel update was more than five seconds ago. The second panel's content is always updated.  
   
  [!code-aspx-csharp[System.Web.UI.UpdatePanel.UpdateMode#1](~/samples/snippets/csharp/VS_Snippets_Atlas/System.Web.UI.UpdatePanel.UpdateMode/CS/UpdatePanelUpdateModeCS.aspx#1)]
  [!code-aspx-vb[System.Web.UI.UpdatePanel.UpdateMode#1](~/samples/snippets/visualbasic/VS_Snippets_Atlas/System.Web.UI.UpdatePanel.UpdateMode/VB/UpdatePanelUpdateModeVB.aspx#1)]  

xml/System.Windows.Automation/PropertyConditionFlags.xml

@@ -24,17 +24,17 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Examples  
- In the following example, IgnoreCase is set in a <xref:System.Windows.Automation.PropertyConditionFlags.IgnoreCase>.  
+ In the following example, `IgnoreCase` is set in a <xref:System.Windows.Automation.PropertyCondition?displayProperty=nameWithType>.  
   
  [!code-csharp[UIAClient_snip#110](~/samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#110)]
  [!code-vb[UIAClient_snip#110](~/samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#110)]  
   
  ]]></format>
     </remarks>
     <altmember cref="T:System.Windows.Automation.PropertyCondition" />
-    <related type="Article" href="https://msdn.microsoft.com/library/255905af-0b17-485c-93d4-8a2db2a6524b">UI Automation Properties for Clients</related>
-    <related type="Article" href="https://msdn.microsoft.com/library/c2caaf45-e59c-42a1-bc9b-77a6de520171">Obtaining UI Automation Elements</related>
-    <related type="Article" href="https://msdn.microsoft.com/library/006c54c9-50bf-48d9-a855-9d62eb95603a">Get Supported UI Automation Control Patterns</related>
+    <related type="Article" href="~/docs/framework/ui-automation/ui-automation-properties-for-clients.md">UI Automation Properties for Clients</related>
+    <related type="Article" href="~/docs/framework/ui-automation/obtaining-ui-automation-elements.md">Obtaining UI Automation Elements</related>
+    <related type="Article" href="~/docs/framework/ui-automation/get-supported-ui-automation-control-patterns.md">Get Supported UI Automation Control Patterns</related>
   </Docs>
   <Members>
     <Member MemberName="IgnoreCase">

xml/System.Windows.Automation/ToggleState.xml

@@ -27,7 +27,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- A control must cycle through its <xref:System.Windows.Automation.Provider.IToggleProvider.ToggleState?displayProperty=nameWithType> in this order: On, Off, and, if supported, Indeterminate.  
+ A control must cycle through its <xref:System.Windows.Automation.Provider.IToggleProvider.ToggleState?displayProperty=nameWithType> in this order: `On`, `Off`, and, if supported, `Indeterminate`.  
   
  ]]></format>
     </remarks>

xml/System.Windows.Controls.Primitives/TickBarPlacement.xml

@@ -19,14 +19,14 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Windows.Controls.Primitives.TickBarPlacement> enumeration is used to set the <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A> property of a <xref:System.Windows.Controls.Primitives.TickBar>. The actual position of a <xref:System.Windows.Controls.Primitives.TickBar> is defined by the <xref:System.Windows.Controls.ControlTemplate> of a <xref:System.Windows.Controls.Slider> control. The <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A> property identifies this position so that the ticks of a <xref:System.Windows.Controls.Primitives.TickBar> are drawn correctly. The following illustration shows how <xref:System.Windows.Controls.Primitives.TickBar> controls are drawn when the <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A> property is set to Top and Bottom.  
+ The `TickBarPlacement` enumeration is used to set the <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A?displayProperty=nameWithType> property. The actual position of a <xref:System.Windows.Controls.Primitives.TickBar> is defined by the <xref:System.Windows.Controls.ControlTemplate> of a <xref:System.Windows.Controls.Slider> control. The <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A> property identifies this position so that the ticks of a <xref:System.Windows.Controls.Primitives.TickBar> are drawn correctly. The following illustration shows how <xref:System.Windows.Controls.Primitives.TickBar> controls are drawn when the <xref:System.Windows.Controls.Primitives.TickBar.Placement%2A> property is set to `Top` and `Bottom`.  
   
  ![TickBar placement](~/add/media/tickbarplacement.png "TickBar placement")  
   
    
   
 ## Examples  
- For an example of a <xref:System.Windows.Controls.Primitives.TickBarPlacement.Top> that is included in the <xref:System.Windows.Style> of a <xref:System.Windows.Controls.Slider>, see [Slider Styles and Templates](~/docs/framework/wpf/controls/slider-styles-and-templates.md).  
+ For an example of a `TickBarPlacement` that is included in the <xref:System.Windows.Style> of a <xref:System.Windows.Controls.Slider>, see [Slider Styles and Templates](~/docs/framework/wpf/controls/slider-styles-and-templates.md).  
   
  ]]></format>
     </remarks>

xml/System.Windows.Controls.Primitives/TickPlacement.xml

@@ -19,9 +19,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Windows.Controls.Primitives.TickPlacement> enumeration is used to set the <xref:System.Windows.Controls.Slider.TickPlacement%2A> property of a <xref:System.Windows.Controls.Slider>.  
+ The `TickPlacement` enumeration is used to set the <xref:System.Windows.Controls.Slider.TickPlacement%2A?displayProperty=nameWithType> property.  
   
- The following illustration shows a <xref:System.Windows.Controls.Slider> that has tick marks that are located below the <xref:System.Windows.Controls.Primitives.Track>. In this example, the <xref:System.Windows.Controls.Slider.TickPlacement%2A> property is set to BottomRight.  
+ The following illustration shows a <xref:System.Windows.Controls.Slider> that has tick marks that are located below the <xref:System.Windows.Controls.Primitives.Track>. In this example, the <xref:System.Windows.Controls.Slider.TickPlacement%2A?displayProperty=nameWithType> property is set to `BottomRight`.  
   
  **Slider Example**  
   
@@ -30,7 +30,7 @@
    
   
 ## Examples  
- The following example shows how to set the <xref:System.Windows.Controls.Slider.TickPlacement%2A> property for a <xref:System.Windows.Controls.Slider.TickPlacement%2A> control.  
+ The following example shows how to set the <xref:System.Windows.Controls.Slider.TickPlacement%2A?displayProperty=nameWithType> property.  
   
  [!code-xaml[Slider#4](~/samples/snippets/xaml/VS_Snippets_Wpf/Slider/xaml/window1.xaml#4)]