Parameters

path

A string that specifies the complete file path to read. [Edit]

encoding

A System.Text.Encoding that specifies the character encoding to use. [Edit]

detectEncodingFromByteOrderMarks

A bool value that indicates whether the new System.IO.StreamReaderis required to look for byte order marks at the beginning of the stream. Specify true to enable detection of byte order marks; otherwise, specify false . [Edit]

bufferSize

A int that specifies the minimum buffer size, in number of 16-bit characters. If less than the minimum allowable size (128 characters), the minimum allowable size is used. [Edit]

Exceptions

Type	Reason
System.IO.IOException	path is in an invalid format or contains invalid characters. [Edit]
System.IO.DirectoryNotFoundException	The directory information specified in path was not found. [Edit]
System.IO.FileNotFoundException	The file specified in path was not found. [Edit]
ArgumentException	path is an empty string (""). [Edit]
ArgumentNullException	path or encoding is null. [Edit]
ArgumentOutOfRangeException	buffersize is less than or equal to zero. [Edit]

Remarks

This constructor initializes the StreamReader.CurrentEncoding property using encoding .

If requested, the current constructor detects the encoding by examining the first three bytes of the stream. The constructor automatically recognizes UTF-8, little-endian Unicode, and big-endian Unicode text if the file starts with the appropriate byte order marks. Otherwise, the user-provided encoding is used. See the System.Text.Encoding.GetPreamble method for more information.

Note:

path is not required to be a file stored on disk; it can be any part of a system that supports access via streams. For example, depending on the system, this class might be able to access a physical device.

When reading from a System.IO.Stream, it is more efficient to use a buffer that is the same size as the internal buffer of the stream.

For information on the valid format and characters for path strings, see System.IO.Path.

[Edit]

Requirements

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0