Merge pull request #3880 from dotnet/master

mairaw · web-flow · commit c51dea0200e1 · 2020-02-14T08:46:19.000-08:00
Update live with current master
diff --git a/xml/Microsoft.JScript.Vsa/ResInfo.xml b/xml/Microsoft.JScript.Vsa/ResInfo.xml
@@ -54,10 +54,19 @@
         <Parameter Name="isLinked" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="resinfo">To be added.</param>
-        <param name="isLinked">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
-        <remarks>To be added.</remarks>
+        <param name="resinfo">Resource information.</param>
+        <param name="isLinked">
+          <see langword="true" /> to indicate the resource is linked; otherwise, <see langword="false" />.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.JScript.Vsa.ResInfo" /> class with the specified resource information.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ 
+The `resinfo` parameter should be in the format `<filename>[,<name>[,public|private]]`.
+
+ ]]></format>
+        </remarks>
         <forInternalUseOnly />
       </Docs>
     </Member>
@@ -82,11 +91,13 @@
         <Parameter Name="isLinked" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="filename">To be added.</param>
-        <param name="name">To be added.</param>
-        <param name="isPublic">To be added.</param>
-        <param name="isLinked">To be added.</param>
-        <summary>This class, member, or property is internal to the script engine and should not be called from your code.</summary>
+        <param name="filename">The file name.</param>
+        <param name="name">Specifies a name.</param>
+        <param name="isPublic">
+          <see langword="true" /> to indicate <paramref name="filename" /> is public in the assembly; otherwise, <see langword="false" />.</param>
+        <param name="isLinked">
+          <see langword="true" /> to indicate the resource is linked; otherwise, <see langword="false" />.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.JScript.Vsa.ResInfo" /> class with the specified resource information in separate parameters.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
       </Docs>
diff --git a/xml/Microsoft.Vsa/VsaException.xml b/xml/Microsoft.Vsa/VsaException.xml
@@ -86,9 +86,10 @@
         <Parameter Name="message" Type="System.String" Index="0" FrameworkAlternate="netframework-2.0;netframework-3.0;netframework-3.5" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="message">The error message that specifies the reason for the exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Vsa.VsaException" /> class with the specified error message.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -158,10 +159,11 @@
         <Parameter Name="innerException" Type="System.Exception" Index="1" FrameworkAlternate="netframework-2.0;netframework-3.0;netframework-3.5" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <param name="innerException">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="message">The error message that explains the reason for the exception.</param>
+        <param name="innerException">The exception that is the cause of the current exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Vsa.VsaException" /> class with the specified error message and a reference to the inner exception.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -183,11 +185,12 @@
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="error">To be added.</param>
-        <param name="message">To be added.</param>
-        <param name="innerException">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="error">One of the enumeration values that specifies the kind of error.</param>
+        <param name="message">The error message that explains the reason for the exception.</param>
+        <param name="innerException">The exception that is the cause of the current exception.</param>
+        <summary>Initializes a new instance of the <see cref="T:Microsoft.Vsa.VsaException" /> class with the specified error type, error message, and a reference to the inner exception.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="ErrorCode">
diff --git a/xml/Microsoft.Vsa/VsaLoader.xml b/xml/Microsoft.Vsa/VsaLoader.xml
@@ -198,9 +198,10 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="name">The name of the option to get.</param>
+        <summary>Gets implementation-specific options.</summary>
         <returns>To be added.</returns>
+        <forInternalUseOnly />
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -327,10 +328,11 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="identifier">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="identifier">A string value provided as identifier.</param>
+        <summary>Checks whether the supplied identifier is valid.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Items">
@@ -671,10 +673,11 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</summary>
+        <param name="name">The name of the option to set.</param>
+        <param name="value">The value for the option being set.</param>
+        <summary>Sets implementation-specific options.</summary>
         <remarks>To be added.</remarks>
+        <forInternalUseOnly />
       </Docs>
     </Member>
     <Member MemberName="Site">
diff --git a/xml/Microsoft_VsaVb/VsaEngineClass.xml b/xml/Microsoft_VsaVb/VsaEngineClass.xml
@@ -506,7 +506,7 @@
         <Parameter Name="Site" Type="Microsoft.Vsa.IVsaPersistSite" />
       </Parameters>
       <Docs>
-        <param name="Site">To be added.</param>
+        <param name="Site">The site from which the specified source items is loaded.</param>
         <summary>Directs the script engine to load source items from their point of persistence, as specified by the host-provided object that implements the <see cref="T:Microsoft.Vsa.IVsaPersistSite" /> interface.</summary>
         <remarks>To be added.</remarks>
         <forInternalUseOnly />
diff --git a/xml/System.Drawing.Design/IconEditor.xml b/xml/System.Drawing.Design/IconEditor.xml
@@ -123,7 +123,7 @@
         <Parameter Name="e" Type="System.Drawing.Design.IconEditor" Index="0" FrameworkAlternate="netframework-1.1;netframework-2.0;netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8" />
       </Parameters>
       <Docs>
-        <param name="editor">To be added.</param>
+        <param name="editor">The <see cref="T:System.Drawing.Design.IconEditor" /> for which the filter string will be created.</param>
         <param name="e">The <see cref="T:System.Drawing.Design.IconEditor" /> for which the filter string will be created.</param>
         <summary>Creates a filter string for the file dialog box.</summary>
         <returns>The filter string, created from the string returned by <see cref="M:System.Drawing.Design.IconEditor.CreateExtensionsString(System.String[],System.String)" />.</returns>
diff --git a/xml/System.Net/FileWebResponse.xml b/xml/System.Net/FileWebResponse.xml
@@ -290,7 +290,8 @@
         <Parameter Name="disposing" Type="System.Boolean" Index="0" FrameworkAlternate="netframework-1.1" />
       </Parameters>
       <Docs>
-        <param name="disposing">To be added.</param>
+        <param name="disposing">
+          <see langword="true" /> to release both managed and unmanaged resources; otherwise, <see langword="false" />.</param>
         <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.FileWebResponse" /> and optionally releases the managed resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Net/WriteStreamClosedEventHandler.xml b/xml/System.Net/WriteStreamClosedEventHandler.xml
@@ -35,8 +35,8 @@
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
   <Docs>
-    <param name="sender">To be added.</param>
-    <param name="e">To be added.</param>
+    <param name="sender">The source of the event.</param>
+    <param name="e">The event data.</param>
     <summary>Represents the method that will handle the <see cref="E:System.Net.WebClient.WriteStreamClosed" /> event of a <see cref="T:System.Net.WebClient" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
diff --git a/xml/System.ServiceModel.Channels/UdpTransportBindingElement.xml b/xml/System.ServiceModel.Channels/UdpTransportBindingElement.xml
@@ -419,7 +419,7 @@
       </Parameters>
       <Docs>
         <param name="importer">The <see cref="T:System.ServiceModel.Description.MetadataImporter" /> object in use.</param>
-        <param name="policyContext">To be added.</param>
+        <param name="policyContext">The policy context.</param>
         <summary>Imports custom policy assertions and adds implementing binding elements.</summary>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Threading/WaitHandle.xml b/xml/System.Threading/WaitHandle.xml
@@ -890,7 +890,7 @@ Calling `Dispose` allows the resources used by the <xref:System.Threading.WaitHa
   
  -or-  
   
- The current thread is <see cref="F:System.Threading.ApartmentState.STA" /> state, and <paramref name="waitHandles" /> contains more than one element.</exception>
+ The current thread is in <see cref="F:System.Threading.ApartmentState.STA" /> state, and <paramref name="waitHandles" /> contains more than one element.</exception>
         <exception cref="T:System.ApplicationException">
           <paramref name="waitHandles" /> is an array with no elements and the .NET Framework version is 1.0 or 1.1.</exception>
         <exception cref="T:System.Threading.AbandonedMutexException">The wait terminated because a thread exited without releasing a mutex. This exception is not thrown on Windows 98 or Windows Millennium Edition.</exception>
diff --git a/xml/System.Web.Hosting/LowPhysicalMemoryObserver.xml b/xml/System.Web.Hosting/LowPhysicalMemoryObserver.xml
@@ -112,7 +112,7 @@
         <Parameter Name="lowMemoryInfo" Type="System.Web.Hosting.LowPhysicalMemoryInfo" />
       </Parameters>
       <Docs>
-        <param name="lowMemoryInfo">To be added.</param>
+        <param name="lowMemoryInfo">The new data to send to the observer.</param>
         <summary>Provides the observer with new data.</summary>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Web.Hosting/RecycleLimitObserver.xml b/xml/System.Web.Hosting/RecycleLimitObserver.xml
@@ -85,7 +85,7 @@
         <Parameter Name="error" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="error">To be added.</param>
+        <param name="error">The exception.</param>
         <summary>Has no effect in the <see cref="T:System.Web.Hosting.RecycleLimitObserver" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Web.UI/ClientIDMode.xml b/xml/System.Web.UI/ClientIDMode.xml
@@ -35,11 +35,11 @@
   
  This example creates HTML with three `ProductIDLabel` controls. When the page runs, the IDs for the controls will be the following:  
   
--   `ListView1_ProductIDLabel_1`  
-  
--   `ListView1_ProductIDLabel_34`  
-  
--   `ListView1_ProductIDLabel_43`  
+- `ListView1_ProductIDLabel_1`
+- `ListView1_ProductIDLabel_34`
+- `ListView1_ProductIDLabel_43`
+
+[!code-aspx-csharp[System.Web.UI.ClientIDMode#11](~/samples/snippets/common/VS_Snippets_WebNet/system.web.ui.clientidmode/common/predictable.aspx#11)]
   
  ]]></format>
     </remarks>
diff --git a/xml/System.Web.UI/Control.xml b/xml/System.Web.UI/Control.xml
@@ -718,15 +718,15 @@ span#ProductIDLabel { background-color: white; }
 
  The following example shows the user control.
 
-
+ [!code-aspx-csharp[System.Web.UI.ClientIDMode#1](~/samples/snippets/common/VS_Snippets_WebNet/system.web.ui.clientidmode/common/seasons.ascx)]
 
  The following example shows the content page that contains the user control.
 
-
+ [!code-aspx-csharp[System.Web.UI.ClientIDMode#2](~/samples/snippets/common/VS_Snippets_WebNet/system.web.ui.clientidmode/common/seasons.aspx)]
 
  The following example shows the master page that contains the content page.
 
-
+ [!code-aspx-csharp[System.Web.UI.ClientIDMode#3](~/samples/snippets/common/VS_Snippets_WebNet/system.web.ui.clientidmode/common/seasons.master)]
 
  ]]></format>
         </remarks>
@@ -789,15 +789,14 @@ span#ProductIDLabel { background-color: white; }
 
 
 ## Examples
- The following example shows <xref:System.Web.UI.WebControls.Label> controls that are contained in a <xref:System.Web.UI.WebControls.ListView> control. On the <xref:System.Web.UI.WebControls.ListView> control, the <xref:System.Web.UI.Control.ClientIDMode%2A> property is set to <xref:System.Web.UI.ClientIDMode.Predictable> and the <xref:System.Web.UI.WebControls.ListView.ClientIDRowSuffix%2A> property is set to `ProductID`. In the rendered HTML, this creates three `span` elements that correspond to three `ProductIDLabel` controls. When the page runs, the `id` attributes for the `span` elements are set to the following values:
-
--   `ListView1_ProductIDLabel_1`
-
--   `ListView1_ProductIDLabel_34`
 
--   `ListView1_ProductIDLabel_43`
+The following example shows <xref:System.Web.UI.WebControls.Label> controls that are contained in a <xref:System.Web.UI.WebControls.ListView> control. On the <xref:System.Web.UI.WebControls.ListView> control, the <xref:System.Web.UI.Control.ClientIDMode%2A> property is set to <xref:System.Web.UI.ClientIDMode.Predictable> and the <xref:System.Web.UI.WebControls.ListView.ClientIDRowSuffix%2A> property is set to `ProductID`. In the rendered HTML, this creates three `span` elements that correspond to three `ProductIDLabel` controls. When the page runs, the `id` attributes for the `span` elements are set to the following values:
 
+- `ListView1_ProductIDLabel_1`
+- `ListView1_ProductIDLabel_34`
+- `ListView1_ProductIDLabel_43`
 
+[!code-aspx-csharp[System.Web.UI.ClientIDMode#11](~/samples/snippets/common/VS_Snippets_WebNet/system.web.ui.clientidmode/common/predictable.aspx#11)]
 
  ]]></format>
         </remarks>
@@ -1669,7 +1668,8 @@ span#ProductIDLabel { background-color: white; }
 ## Examples
  The following example creates an event, named `Click`, that adds and removes handlers from the control's <xref:System.ComponentModel.EventHandlerList> collection when the event is called from a page.
 
- **Note** This example optimizes how a control adds and removes events from the list of them that the control maintains. If you create custom control and want to define an event, use code similar to this. This technique can be used in C#, but not in Visual Basic.
+ > [!NOTE]
+ > This example optimizes how a control adds and removes events from the list of them that the control maintains. If you create custom control and want to define an event, use code similar to this. This technique can be used in C#, but not in Visual Basic.
 
  [!code-csharp[System.Web.UI.Page_VerifyRenderingInServerForm#1](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.UI.Page_VerifyRenderingInServerForm/CS/testlinkbutton.cs#1)]
 
