﻿<?xml version="1.0" encoding="utf-8"?><Type Name="StreamReader" FullName="System.IO.StreamReader" FullNameSP="System_IO_StreamReader" Maintainer="ecma"><TypeSignature Language="ILASM" Value=".class public serializable StreamReader extends System.IO.TextReader" /><TypeSignature Language="C#" Value="public class StreamReader : System.IO.TextReader" /><TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit StreamReader extends System.IO.TextReader" /><MemberOfLibrary>BCL</MemberOfLibrary><AssemblyInfo><AssemblyName>mscorlib</AssemblyName><AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement><Base><BaseTypeName>System.IO.TextReader</BaseTypeName></Base><Interfaces></Interfaces><Attributes><Attribute><AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName></Attribute></Attributes><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para><see cref="T:System.IO.StreamReader" /> is designed for character input in a particular encoding, whereas the <see cref="T:System.IO.Stream" /> class is designed for byte input and output. Use <see cref="T:System.IO.StreamReader" /> for reading lines of information from a standard text file.</para><para><see cref="T:System.IO.StreamReader" /> defaults to UTF-8 encoding unless specified otherwise, instead of defaulting to the ANSI code page for the current system. UTF-8 handles Unicode characters correctly and provides consistent results on localized versions of the operating system. If you get the current character encoding using the <see cref="P:System.IO.StreamReader.CurrentEncoding" /> property, the value is not reliable until after the first <see cref="M:System.IO.StreamReader.Read" /> method, since encoding auto detection is not done until the first call to a <see cref="M:System.IO.StreamReader.Read" /> method.</para><para>By default, a <see cref="T:System.IO.StreamReader" /> is not thread safe. See <see cref="M:System.IO.TextReader.Synchronized(System.IO.TextReader)" /> for a thread-safe wrapper.</para><para>The <see cref="M:System.IO.StreamReader.Read(System.Char[],System.Int32,System.Int32)" />  and <see cref="M:System.IO.StreamWriter.Write(System.Char[],System.Int32,System.Int32)" />  method overloads read and write the number of characters specified by the <paramref name="count" /> parameter. These are to be distinguished from <see cref="M:System.IO.BufferedStream.Read(System.Byte[],System.Int32,System.Int32)" /> and <see cref="M:System.IO.BufferedStream.Write(System.Byte[],System.Int32,System.Int32)" />, which read and write the number of bytes specified by the <paramref name="count" /> parameter. Use the <see cref="T:System.IO.BufferedStream" /> methods only for reading and writing an integral number of byte array elements.</para><block subset="none" type="note"><para>When reading from a <see cref="T:System.IO.Stream" />, it is more efficient to use a buffer that is the same size as the internal buffer of the stream.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Implements a <see cref="T:System.IO.TextReader" /> that reads characters from a byte stream in a particular encoding.</para></summary></Docs><Members><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.IO.Stream stream)" /><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="stream" Type="System.IO.Stream" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="stream" /> does not support reading.</exception><exception cref="T:System.ArgumentNullException"><paramref name="stream" /> is <see langword="null" />.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding to <see cref="T:System.Text.UTF8Encoding" />, the <see cref="P:System.IO.StreamReader.BaseStream" /> property using the <paramref name="stream" /> parameter, and the internal buffer size to 1024 bytes.</para><para>The <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called. </para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified stream.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to be read. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string path)" /><MemberSignature Language="C#" Value="public StreamReader (string path);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string path) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="path" Type="System.String" /></Parameters><Docs><exception cref="T:System.IO.IOException"><paramref name="path" /> is in an invalid format or contains invalid characters.</exception><exception cref="T:System.IO.DirectoryNotFoundException">The directory information specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.ArgumentException"><paramref name="path " /> is an empty string ("").</exception><exception cref="T:System.ArgumentNullException"><paramref name="path " /> is <see langword="null" />.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The complete file path is specified by the <paramref name="path" /> parameter. This constructor initializes the encoding to <see cref="T:System.Text.UTF8Encoding" /> and the buffer size to 1024 bytes.</para><para>The <paramref name="path" /> parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.</para><para>The <paramref name="path" /> parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified file name.</para></summary><param name="path"><attribution license="cc4" from="Microsoft" modified="false" />The complete file path to be read. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.IO.Stream stream, bool detectEncodingFromByteOrderMarks)" /><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream, bool detectEncodingFromByteOrderMarks);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, bool detectEncodingFromByteOrderMarks) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="stream" Type="System.IO.Stream" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="stream" /> does not support reading.</exception><exception cref="T:System.ArgumentNullException"><paramref name="stream " /> is <see langword="null" />.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding to <see cref="T:System.Text.UTF8Encoding" />, the <see cref="P:System.IO.StreamReader.BaseStream" /> property using the <paramref name="stream" /> parameter, and the internal buffer size to 1024 bytes.</para><para>The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It automatically recognizes UTF-8, little-endian Unicode, and big-endian Unicode text if the file starts with the appropriate byte order marks. See the <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified stream, with the specified byte order mark detection option.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to be read. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding)" /><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream, System.Text.Encoding encoding);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="stream" Type="System.IO.Stream" /><Parameter Name="encoding" Type="System.Text.Encoding" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="stream" /> does not support reading.</exception><exception cref="T:System.ArgumentNullException"><paramref name="stream " /> or <paramref name="encoding" /> is <see langword="null" />.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The character encoding is set by the <paramref name="encoding" /> parameter, and the buffer size is set to 1024 bytes. The <see cref="T:System.IO.StreamReader" /> object attempts to  detect the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified stream, with the specified character encoding.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string path, bool detectEncodingFromByteOrderMarks)" /><MemberSignature Language="C#" Value="public StreamReader (string path, bool detectEncodingFromByteOrderMarks);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string path, bool detectEncodingFromByteOrderMarks) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="path" Type="System.String" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /></Parameters><Docs><exception cref="T:System.IO.IOException"><paramref name="path" /> is in an invalid format or contains invalid characters.</exception><exception cref="T:System.IO.DirectoryNotFoundException">The directory information specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.ArgumentException"><paramref name="path " />is an empty string ("").</exception><exception cref="T:System.ArgumentNullException"><paramref name="path " /> is <see langword="null" />.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding to <see cref="T:System.Text.UTF8Encoding" />, the <see cref="P:System.IO.StreamReader.BaseStream" /> property using the <paramref name="stream" /> parameter, and the internal buffer size to 1024 bytes.</para><para>The <paramref name="path" /> parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.</para><para>The <paramref name="path" /> parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.</para><para>The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It automatically recognizes UTF-8, little-endian Unicode, and big-endian Unicode text if the file starts with the appropriate byte order marks. Otherwise, the <see cref="T:System.Text.UTF8Encoding" /> is used. See the <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified file name, with the specified byte order mark detection option.</para></summary><param name="path"><attribution license="cc4" from="Microsoft" modified="false" />The complete file path to be read. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string path, class System.Text.Encoding encoding)" /><MemberSignature Language="C#" Value="public StreamReader (string path, System.Text.Encoding encoding);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string path, class System.Text.Encoding encoding) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="path" Type="System.String" /><Parameter Name="encoding" Type="System.Text.Encoding" /></Parameters><Docs><exception cref="T:System.IO.IOException"><paramref name="path" /> is in an invalid format or contains invalid characters.</exception><exception cref="T:System.IO.DirectoryNotFoundException">The directory information specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.ArgumentException"><paramref name="path " />is an empty string ("").</exception><exception cref="T:System.ArgumentNullException"><paramref name="path " />or <paramref name="encoding" /> is <see langword="null" /> .</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding as specified by the <paramref name="encoding" /> parameter, and the internal buffer size to 1024 bytes. The <see cref="T:System.IO.StreamReader" /> object attempts to  detect the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <paramref name="path" /> parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.</para><para>The <paramref name="path" /> parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified file name, with the specified character encoding.</para></summary><param name="path"><attribution license="cc4" from="Microsoft" modified="false" />The complete file path to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks)" /><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="stream" Type="System.IO.Stream" /><Parameter Name="encoding" Type="System.Text.Encoding" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="stream" /> does not support reading.</exception><exception cref="T:System.ArgumentNullException"><paramref name="stream " />or <paramref name="encoding" /> is <see langword="null" /> .</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding as specified by the <paramref name="encoding" /> parameter, the <see cref="P:System.IO.StreamReader.BaseStream" /> property using the <paramref name="stream" /> parameter, and the internal buffer size to 1024 bytes.</para><para>The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified stream, with the specified character encoding and byte order mark detection option.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string path, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks)" /><MemberSignature Language="C#" Value="public StreamReader (string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string path, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="path" Type="System.String" /><Parameter Name="encoding" Type="System.Text.Encoding" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /></Parameters><Docs><exception cref="T:System.IO.IOException"><paramref name="path" /> is in an invalid format or contains invalid characters.</exception><exception cref="T:System.IO.DirectoryNotFoundException">The directory information specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.ArgumentException"><paramref name="path " /> is an empty string ("").</exception><exception cref="T:System.ArgumentNullException"><paramref name="path " /> or <paramref name="encoding" /> is <see langword="null" /> .</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding as specified by the <paramref name="encoding" /> parameter, and the internal buffer size to 1024 bytes.</para><para>The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <paramref name="path" /> parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.</para><para>The <paramref name="path" /> parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified file name, with the specified character encoding and byte order mark detection option.</para></summary><param name="path"><attribution license="cc4" from="Microsoft" modified="false" />The complete file path to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int32 bufferSize)" /><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int32 bufferSize) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="stream" Type="System.IO.Stream" /><Parameter Name="encoding" Type="System.Text.Encoding" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /><Parameter Name="bufferSize" Type="System.Int32" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="stream" /> does not support reading.</exception><exception cref="T:System.ArgumentNullException"><paramref name="stream " />or <paramref name="encoding" /> is <see langword="null" />.</exception><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="bufferSize " />is less than or equal to zero.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The buffer size, in number of 16-bit characters, is set by the <paramref name="bufferSize" /> parameter. If <paramref name="bufferSize" /> is less than the minimum allowable size (128 characters), the minimum allowable size is used.</para><para>This constructor allows you to change the encoding the first time you read from the <see cref="T:System.IO.StreamReader" /> object. The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called.</para><block subset="none" type="note"><para>When reading from a <see cref="T:System.IO.Stream" />, it is more efficient to use a buffer that is the same size as the internal buffer of the stream.</para></block><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified stream, with the specified character encoding, byte order mark detection option, and buffer size.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param><param name="bufferSize"><attribution license="cc4" from="Microsoft" modified="false" />The minimum buffer size. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="ILASM" Value="public rtspecialname specialname instance void .ctor(string path, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int32 bufferSize)" /><MemberSignature Language="C#" Value="public StreamReader (string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string path, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int32 bufferSize) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters><Parameter Name="path" Type="System.String" /><Parameter Name="encoding" Type="System.Text.Encoding" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /><Parameter Name="bufferSize" Type="System.Int32" /></Parameters><Docs><exception cref="T:System.IO.IOException"><paramref name="path" /> is in an invalid format or contains invalid characters.</exception><exception cref="T:System.IO.DirectoryNotFoundException">The directory information specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.IO.FileNotFoundException">The file specified in <paramref name="path" /> was not found.</exception><exception cref="T:System.ArgumentException"><paramref name="path " />is an empty string ("").</exception><exception cref="T:System.ArgumentNullException"><paramref name="path " /> or <paramref name="encoding" /> is <see langword="null" />.</exception><exception cref="T:System.ArgumentOutOfRangeException"><paramref name="buffersize" /> is less than or equal to zero.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This constructor initializes the encoding as specified by the <paramref name="encoding" /> parameter.</para><para>This constructor allows you to change the encoding the first time you read from the <see cref="T:System.IO.StreamReader" /> object. The <paramref name="detectEncodingFromByteOrderMarks" /> parameter detects the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><para>The buffer size, in number of 16-bit characters, is set by the <paramref name="bufferSize" /> parameter. If <paramref name="bufferSize" /> is less than the minimum allowable size (128 characters), the minimum allowable size is used. </para><para>The <paramref name="path" /> parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.</para><para>The <paramref name="path" /> parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.</para><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.</para></block><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> class for the specified file name, with the specified character encoding, byte order mark detection option, and buffer size.</para></summary><param name="path"><attribution license="cc4" from="Microsoft" modified="false" />The complete file path to be read. </param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use. </param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />Indicates whether to look for byte order marks at the beginning of the file. </param><param name="bufferSize"><attribution license="cc4" from="Microsoft" modified="false" />The minimum buffer size, in number of 16-bit characters. </param></Docs><Excluded>0</Excluded></Member><Member MemberName=".ctor"><MemberSignature Language="C#" Value="public StreamReader (System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, class System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int32 bufferSize, bool leaveOpen) cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><Parameters><Parameter Name="stream" Type="System.IO.Stream" /><Parameter Name="encoding" Type="System.Text.Encoding" /><Parameter Name="detectEncodingFromByteOrderMarks" Type="System.Boolean" /><Parameter Name="bufferSize" Type="System.Int32" /><Parameter Name="leaveOpen" Type="System.Boolean" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Unless you set the <paramref name="leaveOpen" /> parameter to true, the <see cref="T:System.IO.StreamReader" /> object calls <see cref="M:System.IO.Stream.Dispose" /> on the provided <see cref="T:System.IO.Stream" /> object when <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> is called.</para><para>The buffer size, in number of 16-bit characters, is set by the <paramref name="bufferSize" /> parameter. If <paramref name="bufferSize" /> is less than the minimum allowable size (128 characters), the minimum allowable size is used.</para><para>This constructor enables you to change the encoding the first time you read from the <see cref="T:System.IO.StreamReader" /> object. If the <paramref name="detectEncodingFromByteOrderMarks" /> parameter is true, the constructor detects the encoding by looking at the first three bytes of the stream. It 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 <see cref="M:System.Text.Encoding.GetPreamble" /> method for more information.</para><block subset="none" type="note"><para>When reading from a <see cref="T:System.IO.Stream" />, it is more efficient to use a buffer that is the same size as the internal buffer of the stream.</para></block><block subset="none" type="note"><para>When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpreted correctly, and could cause an exception to be thrown.</para></block></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.IO.StreamReader" /> 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.</para></summary><param name="stream"><attribution license="cc4" from="Microsoft" modified="false" />The stream to read.</param><param name="encoding"><attribution license="cc4" from="Microsoft" modified="false" />The character encoding to use.</param><param name="detectEncodingFromByteOrderMarks"><attribution license="cc4" from="Microsoft" modified="false" />true to look for byte order marks at the beginning of the file; otherwise, false.</param><param name="bufferSize"><attribution license="cc4" from="Microsoft" modified="false" />The minimum buffer size.</param><param name="leaveOpen"><attribution license="cc4" from="Microsoft" modified="false" />true to leave the stream open after the <see cref="T:System.IO.StreamReader" /> object is disposed; otherwise, false.</param></Docs></Member><Member MemberName="BaseStream"><MemberSignature Language="ILASM" Value=".property class System.IO.Stream BaseStream { public hidebysig virtual specialname class System.IO.Stream get_BaseStream() }" /><MemberSignature Language="C#" Value="public virtual System.IO.Stream BaseStream { get; }" /><MemberSignature Language="ILAsm" Value=".property instance class System.IO.Stream BaseStream" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.IO.Stream</ReturnType></ReturnValue><Parameters /><Docs><value><para>The underlying <see cref="T:System.IO.Stream" /> which the current <see cref="T:System.IO.StreamReader" /> instance is reading.</para></value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>You use this property to access the underlying stream. The <see cref="T:System.IO.StreamReader" /> class buffers input from the underlying stream when you call one of the <see cref="M:System.IO.StreamReader.Read" /> methods. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method; however, this method slows performance and should be called only when absolutely necessary. The <see cref="T:System.IO.StreamReader" /> constructors that have the <paramref name="detectEncodingFromByteOrderMarks" /> parameter can change the encoding the first time you read from the <see cref="T:System.IO.StreamReader" /> object.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Returns the underlying stream.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName="Close"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Close()" /><MemberSignature Language="C#" Value="public override void Close ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Close() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method overrides the <see cref="M:System.IO.TextWriter.Close" /> method.</para><para>This implementation of <see cref="M:System.IO.StreamReader.Close" /> calls the <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> method passing a true value.</para><para>Flushing the stream will not flush its underlying encoder unless you explicitly call <see cref="M:System.IO.StreamReader.Close" />. Setting <see cref="P:System.IO.StreamWriter.AutoFlush" /> to true means that data will be flushed from the buffer to the stream, but the encoder state will not be flushed. This allows the encoder to keep its state (partial characters) so that it can encode the next block of characters correctly. This scenario affects UTF8 and UTF7, where certain characters can be encoded only after the encoder receives the adjacent character or characters.</para><para>Following a call to <see cref="M:System.IO.StreamReader.Close" />, any operations on the reader might raise exceptions.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Closes the <see cref="T:System.IO.StreamReader" /> object and the underlying stream, and releases any system resources associated with the reader.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName="CurrentEncoding"><MemberSignature Language="ILASM" Value=".property class System.Text.Encoding CurrentEncoding { public hidebysig virtual specialname class System.Text.Encoding get_CurrentEncoding() }" /><MemberSignature Language="C#" Value="public virtual System.Text.Encoding CurrentEncoding { get; }" /><MemberSignature Language="ILAsm" Value=".property instance class System.Text.Encoding CurrentEncoding" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Text.Encoding</ReturnType></ReturnValue><Parameters /><Docs><value>
   The current <see cref="T:System.Text.Encoding" /> used by the current reader.
</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets the current character encoding that the current <see cref="T:System.IO.StreamReader" /> object is using.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName="DiscardBufferedData"><MemberSignature Language="ILASM" Value=".method public hidebysig instance void DiscardBufferedData()" /><MemberSignature Language="C#" Value="public void DiscardBufferedData ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig instance void DiscardBufferedData() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Use the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method to reset the internal buffer for the <see cref="T:System.IO.StreamReader" /> object. You need to call this method only when the position of the internal buffer and the <see cref="P:System.IO.StreamReader.BaseStream" /> do not match. These positions can become mismatched when you read data into the buffer and then seek a new position in the underlying stream. This method slows performance and should be used only when absolutely necessary, such as when you want to read a portion of the contents of a <see cref="T:System.IO.StreamReader" /> object more than once. </para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Clears the internal buffer.</para></summary></Docs><Excluded>0</Excluded></Member><Member MemberName="Dispose"><MemberSignature Language="ILASM" Value=".method family hidebysig virtual void Dispose(bool disposing)" /><MemberSignature Language="C#" Value="protected override void Dispose (bool disposing);" /><MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Dispose(bool disposing) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters><Parameter Name="disposing" Type="System.Boolean" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method is called by the public <see cref="M:System.IDisposable.Dispose" /> method and the <see cref="M:System.Object.Finalize" /> method. <see cref="M:System.IDisposable.Dispose" /> invokes the protected <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> method with the <paramref name="disposing" /> parameter set to true. <see cref="M:System.Object.Finalize" /> invokes <see cref="M:System.IO.StreamReader.Dispose(System.Boolean)" /> with <paramref name="disposing" /> set to false.</para><para>When the <paramref name="disposing" /> parameter is true, this method releases all resources held by any managed objects that the <see cref="T:System.IO.StreamReader" /> object references. This method invokes the <see cref="M:System.IDisposable.Dispose" /> method of each referenced object.</para><para>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Closes the underlying stream, releases the unmanaged resources used by the <see cref="T:System.IO.StreamReader" />, and optionally releases the managed resources.</para></summary><param name="disposing"><attribution license="cc4" from="Microsoft" modified="false" />true to release both managed and unmanaged resources; false to release only unmanaged resources. </param></Docs><Excluded>0</Excluded></Member><Member MemberName="EndOfStream"><MemberSignature Language="C#" Value="public bool EndOfStream { get; }" /><MemberSignature Language="ILAsm" Value=".property instance bool EndOfStream" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Boolean</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks>To be added.</remarks><since version=".NET 2.0" /><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets a value that indicates whether the current stream position is at the end of the stream.</para></summary></Docs></Member><Member MemberName="Null"><MemberSignature Language="C#" Value="public static readonly System.IO.StreamReader Null;" /><MemberSignature Language="ILAsm" Value=".field public static initonly class System.IO.StreamReader Null" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.IO.StreamReader</ReturnType></ReturnValue><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>When read methods are invoked on <see cref="F:System.IO.StreamReader.Null" />, zero is always returned. When <see cref="M:System.IO.StreamReader.ReadLine" /> is invoked on <see cref="F:System.IO.StreamReader.Null" />, null is returned.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>A <see cref="T:System.IO.StreamReader" /> object around an empty stream.</para></summary></Docs></Member><Member MemberName="Peek"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 Peek()" /><MemberSignature Language="C#" Value="public override int Peek ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 Peek() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters /><Docs><exception cref="T:System.IO.IOException">An I/O error occurred.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The <see cref="M:System.IO.StreamReader.Peek" /> method returns an integer value in order to determine whether the end of the file, or another error has occurred. This allows a user to first check if the returned value is -1 before casting it to a <see cref="T:System.Char" /> type.</para><para>This method overrides <see cref="M:System.IO.TextReader.Peek" />.</para><para>The current position of the <see cref="T:System.IO.StreamReader" /> object is not changed by <see cref="M:System.IO.StreamReader.Peek" />. </para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Returns the next available character but does not consume it.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>An integer representing the next character to be read, or -1 if there are no characters to be read or if the stream does not support seeking.</para></returns></Docs><Excluded>0</Excluded></Member><Member MemberName="Read"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 Read()" /><MemberSignature Language="C#" Value="public override int Read ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 Read() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters /><Docs><exception cref="T:System.IO.IOException">An I/O error occurred.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method overrides <see cref="M:System.IO.TextReader.Read" />.</para><para>This method returns an integer so that it can return -1 if the end of the stream has been reached. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method; however, this method slows performance and should be called only when absolutely necessary.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads the next character from the input stream and advances the character position by one character.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>The next character from the input stream represented as an <see cref="T:System.Int32" /> object, or -1 if no more characters are available.</para></returns></Docs><Excluded>0</Excluded></Member><Member MemberName="Read"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 Read(class System.Char[] buffer, int32 index, int32 count)" /><MemberSignature Language="C#" Value="public override int Read (char[] buffer, int index, int count);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 Read(char[] buffer, int32 index, int32 count) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters><Parameter Name="buffer" Type="System.Char[]" /><Parameter Name="index" Type="System.Int32" /><Parameter Name="count" Type="System.Int32" /></Parameters><Docs><exception cref="T:System.ArgumentException"><paramref name="buffer" /> .Length - <paramref name="index" /> &lt; <paramref name="count" /> .</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.IO.IOException"><para> An I/O error occurred.</para><para>-or-</para><para>The current stream is closed.</para></exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method overrides <see cref="M:System.IO.TextReader.Read" />.</para><para>This method returns an integer so that it can return 0 if the end of the stream has been reached.</para><para>When using the <see cref="M:System.IO.StreamReader.Read(System.Char[],System.Int32,System.Int32)" /> method, it is more efficient to use a buffer that is the same size as the internal buffer of the stream, where the internal buffer is set to your desired block size, and to always read less than the block size. If the size of the internal buffer was unspecified when the stream was constructed, its default size is 4 kilobytes (4096 bytes). If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method; however, this method slows performance and should be called only when absolutely necessary.</para><para>This method returns after either the number of characters specified by the <paramref name="count" /> parameter are read, or the end of the file is reached. <see cref="M:System.IO.TextReader.ReadBlock(System.Char[],System.Int32,System.Int32)" /> is a blocking version of <see cref="Overload:System.IO.StreamReader.Read" />.</para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a specified maximum of characters from the current stream into a buffer, beginning at the specified index.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>The number of characters that have been read, or 0 if at the end of the stream and no data was read. The number will be less than or equal to the <paramref name="count" /> parameter, depending on whether the data is available within the stream.</para></returns><param name="buffer"><attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index + count - 1" />) replaced by the characters read from the current source. </param><param name="index"><attribution license="cc4" from="Microsoft" modified="false" />The index of <paramref name="buffer" /> at which to begin writing. </param><param name="count"><attribution license="cc4" from="Microsoft" modified="false" />The maximum number of characters to read. </param></Docs><Excluded>0</Excluded></Member><Member MemberName="ReadAsync"><MemberSignature Language="C#" Value="public override System.Threading.Tasks.Task&lt;int&gt; ReadAsync (char[] buffer, int index, int count);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Threading.Tasks.Task`1&lt;int32&gt; ReadAsync(char[] buffer, int32 index, int32 count) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Threading.Tasks.Task&lt;System.Int32&gt;</ReturnType></ReturnValue><Parameters><Parameter Name="buffer" Type="System.Char[]" /><Parameter Name="index" Type="System.Int32" /><Parameter Name="count" Type="System.Int32" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The task completes after either the number of characters specified by the <paramref name="count" /> parameter are read or the end of the stream is reached.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a specified maximum number of characters from the current stream asynchronously and writes the data to a buffer, beginning at the specified index. </para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.</para></returns><param name="buffer"><attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param><param name="index"><attribution license="cc4" from="Microsoft" modified="false" />The position in <paramref name="buffer" /> at which to begin writing.</param><param name="count"><attribution license="cc4" from="Microsoft" modified="false" />The maximum number of characters to read. If the end of the stream is reached before the specified number of characters is written into the buffer, the current method returns.</param></Docs></Member><Member MemberName="ReadBlock"><MemberSignature Language="C#" Value="public override int ReadBlock (char[] buffer, int index, int count);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 ReadBlock(char[] buffer, int32 index, int32 count) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters><Parameter Name="buffer" Type="System.Char[]" /><Parameter Name="index" Type="System.Int32" /><Parameter Name="count" Type="System.Int32" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The position of the underlying stream is advanced by the number of characters that were read into <paramref name="buffer" />.</para><para>The method blocks until either <paramref name="count" /> characters are read, or the end of the stream has been reached. This is a blocking version of <see cref="M:System.IO.StreamReader.Read" />.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>The number of characters that have been read. The number will be less than or equal to <paramref name="count" />, depending on whether all input characters have been read.</para></returns><param name="buffer"><attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index + count - 1" />) replaced by the characters read from the current source.</param><param name="index"><attribution license="cc4" from="Microsoft" modified="false" />The position in <paramref name="buffer" /> at which to begin writing.</param><param name="count"><attribution license="cc4" from="Microsoft" modified="false" />The maximum number of characters to read.</param></Docs></Member><Member MemberName="ReadBlockAsync"><MemberSignature Language="C#" Value="public override System.Threading.Tasks.Task&lt;int&gt; ReadBlockAsync (char[] buffer, int index, int count);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Threading.Tasks.Task`1&lt;int32&gt; ReadBlockAsync(char[] buffer, int32 index, int32 count) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Threading.Tasks.Task&lt;System.Int32&gt;</ReturnType></ReturnValue><Parameters><Parameter Name="buffer" Type="System.Char[]" /><Parameter Name="index" Type="System.Int32" /><Parameter Name="count" Type="System.Int32" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The task does not complete until either the number of characters specified by the <paramref name="count" /> parameter are read, or the end of the stream has been reached.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a specified maximum number of characters from the current stream asynchronously and writes the data to a buffer, beginning at the specified index.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.</para></returns><param name="buffer"><attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param><param name="index"><attribution license="cc4" from="Microsoft" modified="false" />The position in <paramref name="buffer" /> at which to begin writing.</param><param name="count"><attribution license="cc4" from="Microsoft" modified="false" />The maximum number of characters to read. If the end of the stream is reached before the specified number of characters is written into the buffer, the method returns.</param></Docs></Member><Member MemberName="ReadLine"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual string ReadLine()" /><MemberSignature Language="C#" Value="public override string ReadLine ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ReadLine() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.String</ReturnType></ReturnValue><Parameters /><Docs><exception cref="T:System.IO.IOException">An I/O error occurred.</exception><exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>A line is defined as a sequence of characters followed by a line feed ("\n"), a carriage return ("\r"), or a carriage return immediately followed by a line feed ("\r\n"). The string that is returned does not contain the terminating carriage return or line feed. The returned value is null if the end of the input stream is reached.</para><para>This method overrides <see cref="M:System.IO.TextReader.ReadLine" />.</para><para>If the current method throws an <see cref="T:System.OutOfMemoryException" />, the reader's position in the underlying <see cref="T:System.IO.Stream" /> object is advanced by the number of characters the method was able to read, but the characters already read into the internal <see cref="M:System.IO.StreamReader.ReadLine" /> buffer are discarded. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method; however, this method slows performance and should be called only when absolutely necessary. </para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a line of characters from the current stream and returns the data as a string.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>The next line from the input stream, or null if the end of the input stream is reached.</para></returns></Docs><Excluded>0</Excluded></Member><Member MemberName="ReadLineAsync"><MemberSignature Language="C#" Value="public override System.Threading.Tasks.Task&lt;string&gt; ReadLineAsync ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Threading.Tasks.Task`1&lt;string&gt; ReadLineAsync() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Threading.Tasks.Task&lt;System.String&gt;</ReturnType></ReturnValue><Parameters /><Docs><remarks>To be added.</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads a line of characters asynchronously from the current stream and returns the data as a string.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the next line from the stream, or is null if all the characters have been read.</para></returns></Docs></Member><Member MemberName="ReadToEnd"><MemberSignature Language="ILASM" Value=".method public hidebysig virtual string ReadToEnd()" /><MemberSignature Language="C#" Value="public override string ReadToEnd ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ReadToEnd() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.String</ReturnType></ReturnValue><Parameters /><Docs><exception cref="T:System.IO.IOException">An I/O error occurred.</exception><exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method overrides <see cref="M:System.IO.TextReader.ReadToEnd" />.</para><para><see cref="M:System.IO.StreamReader.ReadToEnd" /> works best when you need to read all the input from the current position to the end of the stream. If more control is needed over how many characters are read from the stream, use the <see cref="M:System.IO.StreamReader.Read(System.Char[],System.Int32,System.Int32)" /> method overload, which generally results in better performance.</para><para><see cref="M:System.IO.StreamReader.ReadToEnd" /> assumes that the stream knows when it has reached an end. For interactive protocols in which the server sends data only when you ask for it and does not close the connection, <see cref="M:System.IO.StreamReader.ReadToEnd" /> might block indefinitely because it does not reach an end, and should be avoided. </para><para>Note that when using the <see cref="M:System.IO.StreamReader.Read" />  method, it is more efficient to use a buffer that is the same size as the internal buffer of the stream. If the size of the buffer was unspecified when the stream was constructed, its default size is 4 kilobytes (4096 bytes).</para><para>If the current method throws an <see cref="T:System.OutOfMemoryException" />, the reader's position in the underlying <see cref="T:System.IO.Stream" /> object is advanced by the number of characters the method was able to read, but the characters already read into the internal <see cref="M:System.IO.StreamReader.ReadLine" /> buffer are discarded. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the <see cref="M:System.IO.StreamReader.DiscardBufferedData" /> method; however, this method slows performance and should be called only when absolutely necessary. </para><para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads all characters from the current position to the end of the stream.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>The rest of the stream as a string, from the current position to the end. If the current position is at the end of the stream, returns an empty string ("").</para></returns></Docs><Excluded>0</Excluded></Member><Member MemberName="ReadToEndAsync"><MemberSignature Language="C#" Value="public override System.Threading.Tasks.Task&lt;string&gt; ReadToEndAsync ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.Threading.Tasks.Task`1&lt;string&gt; ReadToEndAsync() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Threading.Tasks.Task&lt;System.String&gt;</ReturnType></ReturnValue><Parameters /><Docs><remarks>To be added.</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Reads all characters from the current position to the end of the stream asynchronously and returns them as one string.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains a string with the characters from the current position to the end of the stream.</para></returns></Docs></Member></Members><TypeExcluded>0</TypeExcluded></Type>