Document System.IO.BinaryReader Read methods (#3206)

* Document System.IO.BinaryReader Read methods

* occurs --> occurred

Author: carlossanlop

xml/System.IO/BinaryReader.xml

@@ -542,7 +542,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached before <paramref name="numBytes" /> could be read.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">Requested <paramref name="numBytes" /> is larger than the internal buffer size.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
@@ -597,7 +597,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ArgumentException">The current character cannot be decoded into the internal character buffer by using the <see cref="T:System.Text.Encoding" /> selected for the stream.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
@@ -672,7 +672,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
         <altmember cref="T:System.Text.Encoding" />
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
@@ -709,10 +709,12 @@
         <Parameter Name="buffer" Type="System.Span&lt;System.Byte&gt;" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="buffer">A region of memory. When this method returns, the contents of this region are replaced by the bytes read from the current source.</param>
+        <summary>Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.</summary>
+        <returns>The total number of bytes read into the buffer. This can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -744,10 +746,12 @@
         <Parameter Name="buffer" Type="System.Span&lt;System.Char&gt;" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="buffer">A span of characters. When this method returns, the contents of this region are replaced by the characters read from the current source.</param>
+        <summary>Reads, from the current stream, the same number of characters as the length of the provided buffer, writes them in the provided buffer, and advances the current position in accordance with the <see langword="Encoding" /> used and the specific character being read from the stream.</summary>
+        <returns>The total number of characters read into the buffer. This might be less than the number of characters requested if that many characters are not currently available, or it might be zero if the end of the stream is reached.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -823,12 +827,10 @@
  -or-  
 
  The number of decoded characters to read is greater than <paramref name="count" />. This can happen if a Unicode decoder returns fallback characters or a surrogate pair.</exception>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="buffer" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="index" /> or <paramref name="count" /> is negative.</exception>
+        <exception cref="T:System.ArgumentNullException"><paramref name="buffer" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index" /> or <paramref name="count" /> is negative.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -908,12 +910,10 @@
  -or-  
 
  The number of decoded characters to read is greater than <paramref name="count" />. This can happen if a Unicode decoder returns fallback characters or a surrogate pair.</exception>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="buffer" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="index" /> or <paramref name="count" /> is negative.</exception>
+        <exception cref="T:System.ArgumentNullException"><paramref name="buffer" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index" /> or <paramref name="count" /> is negative.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -975,7 +975,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.FormatException">The stream is corrupted.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
@@ -1046,7 +1046,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1119,7 +1119,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1196,7 +1196,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">The number of decoded characters to read is greater than <paramref name="count" />. This can happen if a Unicode decoder returns fallback characters or a surrogate pair.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="count" /> is negative.</exception>
@@ -1272,7 +1272,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ArgumentException">A surrogate character was read.</exception>
         <altmember cref="T:System.Text.Encoding" />
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
@@ -1347,9 +1347,8 @@
         </remarks>
         <exception cref="T:System.ArgumentException">The number of decoded characters to read is greater than <paramref name="count" />. This can happen if a Unicode decoder returns fallback characters or a surrogate pair.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
-        <exception cref="T:System.ArgumentOutOfRangeException">
-          <paramref name="count" /> is negative.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count" /> is negative.</exception>
         <altmember cref="T:System.Text.Encoding" />
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
@@ -1406,7 +1405,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1478,7 +1477,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1541,7 +1540,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1607,7 +1606,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1665,7 +1664,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1729,7 +1728,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1800,7 +1799,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1869,7 +1868,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1932,7 +1931,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -1995,7 +1994,7 @@
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>
         <related type="Article" href="~/docs/standard/io/how-to-write-text-to-a-file.md">How to: Write Text to a File</related>
@@ -2057,7 +2056,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached.</exception>
-        <exception cref="T:System.IO.IOException">An I/O error occurs.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
         <related type="Article" href="~/docs/standard/io/index.md">File and Stream I/O</related>
         <related type="Article" href="~/docs/standard/io/how-to-read-text-from-a-file.md">How to: Read Text from a File</related>