Merge pull request #3829 from dotnet/master

Update live with current master

Author: mairaw

xml/System.Data.Common/DbParameter.xml

@@ -758,7 +758,7 @@ FieldName = @OriginalFieldName
       </ReturnValue>
       <Docs>
         <summary>For a description of this member, see <see cref="P:System.Data.IDbDataParameter.Scale" />.</summary>
-        <value>The number of decimal places to which <see cref="T:System.Data.OleDb.OleDbParameter.Value" /> is resolved. The default is 0.</value>
+        <value>The number of decimal places to which <see cref="P:System.Data.OleDb.OleDbParameter.Value" /> is resolved. The default is 0.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

xml/System.IO/FileSystemInfo.xml

@@ -274,11 +274,13 @@
         <exception cref="T:System.IO.FileNotFoundException">The specified file doesn't exist. Only thrown when setting the property value.</exception>
         <exception cref="T:System.IO.DirectoryNotFoundException">The specified path is invalid. For example, it's on an unmapped drive. Only thrown when setting the property value.</exception>
         <exception cref="T:System.Security.SecurityException">The caller doesn't have the required permission.</exception>
+        <exception cref="T:System.UnauthorizedAccessException">.NET Core only: The user attempts to set an attribute value but doesn't have write permission.</exception>
+        <exception cref="T:System.IO.PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length.</exception>
         <exception cref="T:System.ArgumentException">The caller attempts to set an invalid file attribute.  
 
  -or-  
 
- The user attempts to set an attribute value but doesn't have write permission.</exception>
+ .NET Framework only: The user attempts to set an attribute value but doesn't have write permission.</exception>
         <exception cref="T:System.IO.IOException">
           <see cref="M:System.IO.FileSystemInfo.Refresh" /> cannot initialize the data.</exception>
         <permission cref="T:System.Security.Permissions.FileIOPermission">for writing files and directories. Associated enumeration: <see cref="F:System.Security.Permissions.FileIOPermissionAccess.Write" /> Security action: <see cref="F:System.Security.Permissions.SecurityAction.Demand" /></permission>

xml/System.Text/Encoding.xml

@@ -4336,7 +4336,7 @@ The goal is to save this file, then open and decode it as a binary stream.
           <paramref name="bytes" /> is a null pointer.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="byteCount" /> is less than zero.</exception>
-        <exception cref="T:System.Text.DecoderFallbackException">A   fallback occurred (see [Character Encoding in .NET](~/docs/standard/base-types/character-encoding.md) for a complete explanation)
+        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see>) for a complete explanation)
 
  -and-
 

xml/System.Web.DynamicData/MetaModel.xml

@@ -443,8 +443,8 @@
   
  The example consists of a page and its code-behind file.  
   
- [!code-aspx-csharp[System.Web.DynamicData.MetaModel#3](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/CS/GetTable.aspx#3)] -->
- [!code-aspx-vb[System.Web.DynamicData.MetaModel#3](~/samples/snippets/visualbasic/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/VB/GetTable.aspx#3)] --> 
+ [!code-aspx-csharp[System.Web.DynamicData.MetaModel#3](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/CS/GetTable.aspx)]
+ [!code-aspx-vb[System.Web.DynamicData.MetaModel#3](~/samples/snippets/visualbasic/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/VB/GetTable.aspx)]
   
  [!code-csharp[System.Web.DynamicData.MetaModel#4](~/samples/snippets/csharp/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/CS/GetTable.aspx.cs#4)]
  [!code-vb[System.Web.DynamicData.MetaModel#4](~/samples/snippets/visualbasic/VS_Snippets_WebNet/System.Web.DynamicData.MetaModel/VB/gettable.aspx.vb#4)]  

xml/System/Memory`1.xml

@@ -51,6 +51,8 @@ In addition to `Memory<T>`, you can use <xref:System.ReadOnlyMemory%601?displayP
 
     ]]></format>
     </remarks>
+    <related type="article" href="~/docs/standard/memory-and-spans/index.md">Memory- and span-related types</related>
+    <related type="article" href="~/docs/standard/memory-and-spans/memory-t-usage-guidelines.md">Memory&lt;T&gt; and Span&lt;T&gt; usage guidelines</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">

xml/System/ReadOnlyMemory`1.xml

@@ -37,6 +37,8 @@
     <typeparam name="T">The object type from which the contiguous region of memory will be read.</typeparam>
     <summary>Represents a contiguous region of memory, similar to <see cref="T:System.ReadOnlySpan`1" />. Unlike <see cref="T:System.ReadOnlySpan`1" />, it is not a byref-like type.</summary>
     <remarks>To be added.</remarks>
+    <related type="article" href="~/docs/standard/memory-and-spans/index.md">Memory- and span-related types</related>
+    <related type="article" href="~/docs/standard/memory-and-spans/memory-t-usage-guidelines.md">Memory&lt;T&gt; and Span&lt;T&gt; usage guidelines</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">

xml/System/ReadOnlySpan`1.xml

@@ -41,6 +41,8 @@
 
 A `ReadOnlySpan<T>` instance is often used to reference the elements of an array or a portion of an array. Unlike an array, however, a `ReadOnlySpan<T>` instance can point to managed memory, native memory, or memory managed on the stack.]]></format>
     </remarks>
+    <related type="article" href="~/docs/standard/memory-and-spans/index.md">Memory- and span-related types</related>
+    <related type="article" href="~/docs/standard/memory-and-spans/memory-t-usage-guidelines.md">Memory&lt;T&gt; and Span&lt;T&gt; usage guidelines</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">

xml/System/Span`1.xml

@@ -87,6 +87,8 @@ This allocation and copy operation can be eliminated by using either `Span<T>` o
 
       ]]></format>
     </remarks>
+    <related type="article" href="~/docs/standard/memory-and-spans/index.md">Memory- and span-related types</related>
+    <related type="article" href="~/docs/standard/memory-and-spans/memory-t-usage-guidelines.md">Memory&lt;T&gt; and Span&lt;T&gt; usage guidelines</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">

xml/System/Type.xml

@@ -10689,11 +10689,6 @@ GetType(Array).IsAssignableFrom(type)
 
 -   <paramref name="c" /> is a generic type parameter, and the current instance represents one of the constraints of <paramref name="c" />.  
 
-     In the following example, the current instance is a <see cref="T:System.Type" /> object that represents the <see cref="T:System.IO.Stream" /> class. <c>GenericWithConstraint</c> is a generic type whose generic type parameter must be of type    <see cref="T:System.IO.Stream" />. Passing its generic type parameter to the <see cref="M:System.Type.IsAssignableFrom(System.Type)" /> indicates that  an instance of the generic type parameter can be assigned to an <see cref="T:System.IO.Stream" /> object.  
-  
-     [!code-csharp[System.Type.IsAssignableFrom#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.isassignablefrom/cs/IsAssignableFrom2.cs#2)]
-     [!code-vb[System.Type.IsAssignableFrom#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.isassignablefrom/vb/IsAssignableFrom2.vb#2)]  
-  
 -   <paramref name="c" /> represents a value type, and the current instance represents <c>Nullable&lt;c&gt;</c> (<c>Nullable(Of c)</c> in Visual Basic).  
 
  <see langword="false" /> if none of these conditions are true, or if <paramref name="c" /> is <see langword="null" />.</returns>
@@ -10729,6 +10724,12 @@ GetType(Array).IsAssignableFrom(type)
  [!code-cpp[TestIsAssignableFrom#1](~/samples/snippets/cpp/VS_Snippets_CLR/TestIsAssignableFrom/cpp/testisassignablefrom.cpp#1)]
  [!code-csharp[TestIsAssignableFrom#1](~/samples/snippets/csharp/VS_Snippets_CLR/TestIsAssignableFrom/CS/testisassignablefrom.cs#1)]
  [!code-vb[TestIsAssignableFrom#1](~/samples/snippets/visualbasic/VS_Snippets_CLR/TestIsAssignableFrom/VB/testisassignablefrom.vb#1)]  
+
+ In the following example, the current instance is a <xref:System.Type> object that represents the <xref:System.IO.Stream> class. `GenericWithConstraint` is a generic type whose generic type parameter must be of type <xref:System.IO.Stream>. Passing its generic type parameter to the `IsAssignableFrom` method indicates that an instance of the generic type parameter can be assigned to an <xref:System.IO.Stream> object.
+  
+ [!code-csharp[System.Type.IsAssignableFrom#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.type.isassignablefrom/cs/IsAssignableFrom2.cs#2)]
+ [!code-vb[System.Type.IsAssignableFrom#2](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.type.isassignablefrom/vb/IsAssignableFrom2.vb#2)]  
+
 
  ]]></format>
         </remarks>