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

System.IO.File.Create Method

Creates or overwrites the specified file. [Edit]

public static FileStream Create (string path, int bufferSize)

Parameters

path
A string containing the name of the file. [Edit]
bufferSize
A int containing the number of bytes buffered for reads and writes to the file. [Edit]

Returns

A System.IO.FileStream that provides read/write access to the specified file. [Edit]

Permissions

TypeReason
System.Security.Permissions.FileIOPermission [Edit] Requires permission to write 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]
ArgumentNullExceptionpath is null. [Edit]
System.IO.DirectoryNotFoundExceptionThe directory information specified in path was not found. [Edit]
System.IO.IOExceptionAn I/O error occurred while creating the file. [Edit]
UnauthorizedAccessExceptionThe caller does not have the required permission. [Edit]
System.IO.PathTooLongExceptionThe length of path or the absolute path information for path exceeds the system-defined maximum length. [Edit]

Remarks

This method is equivalent to System.IO.FileStream (path, FileMode.Create, FileAccess.ReadWrite, FileShare.None , bufferSize).

If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

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