FileInfo::OpenText Method ()

.NET Framework (current version)

Creates a StreamReader with UTF8 encoding that reads from an existing text file.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
StreamReader^ OpenText()

Return Value

Type: System.IO::StreamReader^

A new StreamReader with UTF8 encoding.

Exceptions

Exception	Condition
SecurityException	The caller does not have the required permission.
FileNotFoundException	The file is not found.
UnauthorizedAccessException	path is read-only or is a directory.
DirectoryNotFoundException	The specified path is invalid, such as being on an unmapped drive.

Examples

The following example reads text from a file.

C++

using namespace System;
using namespace System::IO;
using namespace System::Text;

public ref class OpenTextTest
{
public:
    static void Main()
    {
        String^ path = "c:\\MyTest.txt";

        FileInfo^ fi = gcnew FileInfo(path);

        // Check for existing file
        if (!fi->Exists)
        {
            // Create the file.
            FileStream^ fs = fi->Create();
            array<Byte>^ info =
                (gcnew UTF8Encoding(true))->GetBytes("This is some text in the file.");

            // Add some information to the file.
            fs->Write(info, 0, info->Length);
            fs->Close();
        }

        // Open the stream and read it back.
        StreamReader^ sr = fi->OpenText();
        String^ s = "";
        while ((s = sr->ReadLine()) != nullptr)
        {
            Console::WriteLine(s);
        }
    }
};

int main()
{
    OpenTextTest::Main();
}
//This code produces output similar to the following; 
//results may vary based on the computer/file structure/etc.:
//
//This is some text in the file.
//

Security

FileIOPermission

for reading and writing files. Associated enumerations: FileIOPermissionAccess::Read, FileIOPermissionAccess::Write

Version Information

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0