Mono Class Library: System.IO.File Overview | Members

System.IO.File.AppendText Method

Appends UTF-8 encoded text to an existing file. [Edit]

public static StreamWriter AppendText (string path)

Parameters

path
A string containing the name of the file to append to. [Edit]

Returns

A System.IO.StreamWriter that appends UTF-8 encoded text to the specified file. [Edit]

Permissions

TypeReason
System.Security.Permissions.FileIOPermission [Edit] Requires permission to write to the specified file. See System.Security.Permissions.FileIOPermissionAccess.Write.

Exceptions

TypeReason
System.Security.SecurityExceptionThe caller does not have the required permission. [Edit]
ArgumentExceptionpath is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters. [Edit]
System.IO.FileNotFoundExceptionpath was not found. [Edit]
ArgumentNullExceptionpath is null. [Edit]
System.IO.DirectoryNotFoundExceptionThe directory information specified in path was not found. [Edit]
System.IO.PathTooLongExceptionThe length of path or the absolute path information for path exceeds the implementation-specific maximum length. [Edit]
System.IO.ExceptionA general I/O exception occurred, such as trying to access a CD-ROM drive whose tray is open. [Edit]
System.IO.NotSupportedExceptionpath is in an implementation-specific invalid format. [Edit]
UnauthorizedAccessExceptionAccess is denied. The caller does not have the required permission. [Edit]

Remarks

This method is equivalent to System.IO.StreamWriter (path, true ). If the file specified by path does not exist, it is created. If the file does exist, writes to the System.IO.StreamWriter append text to the file. Additional threads are permitted to read the file while it is open.

The path argument is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory.

Note: To obtain the current working directory, see Directory.GetCurrentDirectory.

[Edit]

Requirements

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