File.Create Method (String, Int32, FileOptions, FileSecurity)

FileCreate Method (String, Int32, FileOptions, FileSecurity)

Creates or overwrites the specified file with the specified buffer size, file options, and file security.

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

Syntax

public static FileStream Create(
	string path,
	int bufferSize,
	FileOptions options,
	FileSecurity fileSecurity
)

path: Type: SystemString
The name of the file.
bufferSize: Type: SystemInt32
The number of bytes buffered for reads and writes to the file.
options: Type: System.IOFileOptions
One of the FileOptions values that describes how to create or overwrite the file.
fileSecurity: Type: System.Security.AccessControlFileSecurity
One of the FileSecurity values that determines the access control and audit security for the file.

Type: FileStream
A new file with the specified buffer size, file options, and file security.

Exceptions

Exception	Condition
UnauthorizedAccessException	The caller does not have the required permission.-or- path specified a file that is read-only.-or-Encrypted is specified for options and file encryption is not supported on the current platform.
ArgumentException	path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
ArgumentNullException	path is null.
PathTooLongException	The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
DirectoryNotFoundException	The specified path is invalid (for example, it is on an unmapped drive).
IOException	An I/O error occurred while creating the file.
NotSupportedException	path is in an invalid format.
UnauthorizedAccessException	The caller does not have the required permission.-or- path specified a file that is read-only.
UnauthorizedAccessException	The caller does not have the required permission.-or- path specified a file that is read-only.