System.IO.File.OpenText Method

Opens an existing UTF-8 encoded text file for reading.

Syntax

public static StreamReader OpenText (string path)

Parameters

path
The file to be opened for reading.

Returns

A System.IO.StreamReader on the specified path.

Exceptions

TypeReason
System.Security.SecurityExceptionThe caller does not have the required permission.
ArgumentException path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.
System.IO.FileNotFoundException path was not found.
ArgumentNullException path is null.
System.IO.DirectoryNotFoundExceptionThe directory information specified in path was not found.
System.IO.PathTooLongExceptionThe length of path or the absolute path information for path exceeds the system-defined maximum length.
UnauthorizedAccessExceptionThe caller does not have the required permission.

Remarks

This method is equivalent to the StreamReader.#ctor(string) constructor overload.

The path parameter is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. To obtain the current working directory, see Directory.GetCurrentDirectory.

For a list of common I/O tasks, see Common I/O Tasks.

Permissions

TypeReason
System.Security.Permissions.FileIOPermissionRequires permission to write to the specified file. See System.Security.Permissions.FileIOPermissionAccess.Write.

Requirements

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