StreamReader Constructor (String^)
Initializes a new instance of the StreamReader class for the specified file name.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- path
-
Type:
System::String^
The complete file path to be read.
| Exception | Condition |
|---|---|
| ArgumentException | path is an empty string (""). |
| ArgumentNullException | path is null. |
| FileNotFoundException | The file cannot be found. |
| DirectoryNotFoundException | The specified path is invalid, such as being on an unmapped drive. |
| IOException | path includes an incorrect or invalid syntax for file name, directory name, or volume label. |
The complete file path is specified by the path parameter. This constructor initializes the encoding to UTF8Encoding and the buffer size to 1024 bytes.
The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.
The 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.
Caution |
|---|
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. |
For a list of common I/O tasks, see Common I-O Tasks.
The following code example demonstrates this StreamReader constructor.
using namespace System; using namespace System::IO; int main() { String^ path = "c:\\temp\\MyTest.txt"; try { if ( File::Exists( path ) ) { File::Delete( path ); } StreamWriter^ sw = gcnew StreamWriter( path ); try { sw->WriteLine( "This" ); sw->WriteLine( "is some text" ); sw->WriteLine( "to test" ); sw->WriteLine( "Reading" ); } finally { delete sw; } StreamReader^ sr = gcnew StreamReader( path ); try { while ( sr->Peek() >= 0 ) { Console::WriteLine( sr->ReadLine() ); } } finally { delete sr; } } catch ( Exception^ e ) { Console::WriteLine( "The process failed: {0}", e ); } }
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
