diff --git a/xml/System.IO/StreamReader.xml b/xml/System.IO/StreamReader.xml
index 6a26aca4752..4897e1dbe24 100644
--- a/xml/System.IO/StreamReader.xml
+++ b/xml/System.IO/StreamReader.xml
@@ -974,13 +974,13 @@
The stream to be read.
The character encoding to use.
Indicates whether to look for byte order marks at the beginning of the file.
- The minimum buffer size.
+ The minimum buffer size, in bytes.
Initializes a new instance of the class for the specified stream, with the specified character encoding, byte order mark detection option, and buffer size.
object. The `detectEncodingFromByteOrderMarks` parameter detects the encoding by looking at the first four bytes of the stream. It automatically recognizes UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32, and big-endian UTF-32 text if the file starts with the appropriate byte order marks. Otherwise, the user-provided encoding is used. See the method for more information.
@@ -1008,7 +1008,7 @@
or is .
- is less than or equal to zero.
+ is less than or equal to zero, except for -1, which is allowed to indicate the default buffer size.
File and Stream I/O
How to: Read Text from a File
@@ -1077,7 +1077,7 @@
The complete file path to be read.
The character encoding to use.
Indicates whether to look for byte order marks at the beginning of the file.
- The minimum buffer size, in number of 16-bit characters.
+ The minimum buffer size, in bytes.
Initializes a new instance of the class for the specified file name, with the specified character encoding, byte order mark detection option, and buffer size.
object. The `detectEncodingFromByteOrderMarks` parameter detects the encoding by looking at the first four bytes of the stream. It automatically recognizes UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32, and big-endian UTF-32 text if the file starts with the appropriate byte order marks. Otherwise, the user-provided encoding is used. See the method for more information.
- The buffer size, in number of 16-bit characters, is set by the `bufferSize` parameter. If `bufferSize` is less than the minimum allowable size (128 characters), the minimum allowable size is used.
+ The buffer size, in bytes, is set by the `bufferSize` parameter. If `bufferSize` is less than the minimum allowable size (128 bytes), the minimum allowable size is used.
The `path` parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.
@@ -1115,7 +1115,7 @@
includes an incorrect or invalid syntax for file name, directory name, or volume label.
- is less than or equal to zero.
+ is less than or equal to zero, except for -1, which is allowed to indicate the default buffer size.
File and Stream I/O
How to: Read Text from a File
@@ -1249,7 +1249,7 @@
The character encoding to use.
to look for byte order marks at the beginning of the file; otherwise, .
- The minimum buffer size.
+ The minimum buffer size, in bytes.
to leave the stream open after the object is disposed; otherwise, .
Initializes a new instance of the class for the specified stream based on the specified character encoding, byte order mark detection option, and buffer size, and optionally leaves the stream open.
@@ -1259,7 +1259,7 @@
## Remarks
Unless you set the `leaveOpen` parameter to `true`, the object calls on the provided object when is called.
- The buffer size, in number of 16-bit characters, is set by the `bufferSize` parameter. If `bufferSize` is less than the minimum allowable size (128 characters), the minimum allowable size is used.
+ The buffer size, in bytes, is set by the `bufferSize` parameter. If `bufferSize` is less than the minimum allowable size (128 bytes), the minimum allowable size is used.
This constructor enables you to change the encoding the first time you read from the object. If the `detectEncodingFromByteOrderMarks` parameter is `true`, the constructor detects the encoding by looking at the first four bytes of the stream. It automatically recognizes UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32, and big-endian UTF-32 text if the file starts with the appropriate byte order marks. Otherwise, the user-provided encoding is used. See the method for more information.
diff --git a/xml/System.IO/StreamWriter.xml b/xml/System.IO/StreamWriter.xml
index abd03066a0d..b375570521b 100644
--- a/xml/System.IO/StreamWriter.xml
+++ b/xml/System.IO/StreamWriter.xml
@@ -612,7 +612,7 @@
The stream to write to.
The character encoding to use.
- The buffer size, in bytes.
+ The buffer size, in characters.
Initializes a new instance of the class for the specified stream by using the specified encoding and buffer size.
or is .
- is negative.
+ is less than or equal to zero, except for -1, which is allowed to indicate the default buffer size.
is not writable.
@@ -871,7 +871,7 @@
The stream to write to.
The character encoding to use.
- The buffer size, in bytes.
+ The buffer size, in characters.
to leave the stream open after the object is disposed; otherwise, .
Initializes a new instance of the class for the specified stream by using the specified encoding and buffer size, and optionally leaves the stream open.
@@ -899,7 +899,7 @@
or is .
- is negative.
+ is less than or equal to zero, except for -1, which is allowed to indicate the default buffer size.
is not writable.
@@ -967,7 +967,7 @@
to append data to the file; to overwrite the file. If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.
The character encoding to use.
- The buffer size, in bytes.
+ The buffer size, in characters.
Initializes a new instance of the class for the specified file on the specified path, using the specified encoding and buffer size. If the file exists, it can be either overwritten or appended to. If the file does not exist, this constructor creates a new file.
or is .
- is negative.
+ is less than or equal to zero, except for -1, which is allowed to indicate the default buffer size.
includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.
The caller does not have the required permission.