Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

File Class

Provides static methods for the creation, copying, deletion, moving, and opening of files, and aids in the creation of FileStream objects.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)
[ComVisibleAttribute(true)]
public static class File

The File type exposes the following members.

  NameDescription
Public methodStatic memberAppendAllLines(String, IEnumerable<String>)When it is called by trusted applications, appends lines to a file, and then closes the file.
Public methodStatic memberAppendAllLines(String, IEnumerable<String>, Encoding)When it is called by trusted applications, appends lines to a file by using a specified encoding, and then closes the file.
Public methodStatic memberAppendAllText(String, String)When it is called by trusted applications, appends the specified string to the file, and then closes the file. If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.
Public methodStatic memberAppendAllText(String, String, Encoding)When called by trusted applications, appends the specified string to the file, creating the file if it does not already exist.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360AppendTextWhen it is called by trusted applications, creates a StreamWriter that appends UTF-8 encoded text to an existing file.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Copy(String, String)When it is called by trusted applications, copies an existing file to a new file. Overwriting a file of the same name is not allowed.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Copy(String, String, Boolean)When it is called by trusted applications, copies an existing file to a new file. Overwriting a file of the same name is allowed.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Create(String)When it is called by trusted applications, creates or overwrites a file in the specified path.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Create(String, Int32)When it is called by trusted applications, creates or overwrites the specified file.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360CreateTextWhen it is called by trusted applications, creates or opens a file for writing UTF-8 encoded text.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360DeleteWhen it is called by trusted applications, deletes the specified file. An exception is not thrown if the specified file does not exist.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360ExistsWhen it is called by trusted applications, determines whether the specified file exists.
Public methodStatic memberGetAttributesGets the FileAttributes of the file on the path.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360GetCreationTimeWhen it is called by trusted applications, returns the creation date and time of the specified file or directory.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360GetLastAccessTimeWhen it is called by trusted applications, returns the date and time the specified file or directory was last accessed.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360GetLastWriteTimeWhen it is called by trusted applications, returns the date and time the specified file or directory was last written to.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360MoveWhen it is called by trusted applications, moves a specified file to a new location, providing the option to specify a new file name.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Open(String, FileMode)When it is called by trusted applications, opens a FileStream on the specified path with read/write access.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Open(String, FileMode, FileAccess)When it is called by trusted applications, opens a FileStream on the specified path, with the specified mode and access.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360Open(String, FileMode, FileAccess, FileShare)When it is called by trusted applications, opens a FileStream on the specified path, having the specified mode with read, write, or read/write access and the specified sharing option.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360OpenReadWhen it is called by trusted applications, opens an existing file for reading.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360OpenTextWhen it is called by trusted applications, opens an existing UTF-8 encoded text file for reading.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360OpenWriteWhen it is called by trusted applications, opens an existing file for writing.
Public methodStatic memberReadAllBytesWhen it is called by trusted applications, opens a binary file, reads the contents of the file into a byte array, and then closes the file.
Public methodStatic memberReadAllText(String)When it is called by trusted applications, opens a text file, reads all lines of the file, and then closes the file.
Public methodStatic memberReadAllText(String, Encoding)When it is called by trusted applications, opens a file, reads all lines of the file with the specified encoding, and then closes the file.
Public methodStatic memberReadLines(String)When it is called by trusted applications, reads the lines of a file.
Public methodStatic memberReadLines(String, Encoding)When it is called by trusted applications, read the lines of a file that has a specified encoding.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360SetAttributesSecurity Critical. Sets the specified FileAttributes of the file on the specified path.
Public methodStatic memberWriteAllBytesWhen it is called by trusted applications, creates a new file, writes the specified byte array to the file, and then closes the file. If the target file already exists, it is overwritten.
Public methodStatic memberWriteAllLines(String, IEnumerable<String>)When it is called by trusted applications, creates a new file, writes a collection of strings to the file, and then closes the file.
Public methodStatic memberWriteAllLines(String, IEnumerable<String>, Encoding)When it is called by trusted applications, creates a new file by using the specified encoding, writes a collection of strings to the file, and then closes the file.
Public methodStatic memberWriteAllText(String, String)When it is called by trusted applications, creates a new file, writes the specified string to the file, and then closes the file. If the target file already exists, it is overwritten.
Public methodStatic memberWriteAllText(String, String, Encoding)When it is called by trusted applications, creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. If the target file already exists, it is overwritten.
Top

Platform Notes

Silverlight for Windows Phone Silverlight for Windows Phone

This type is present to support the .NET Compact Framework infrastructure in Silverlight for Windows Phone, and it is not intended to be used in your application code.

The following example uses a File in a trusted application to determine if a file exists in a users' My Documents folder. This code example is part of a larger example provided for the StreamReader class.


private void OpenFile_Click(object sender, RoutedEventArgs e)
{

	if (Application.Current.HasElevatedPermissions)
	{
		// fileLoc is a global string variable.
		fileLoc = System.IO.Path.Combine(Environment.GetFolderPath(
		   Environment.SpecialFolder.MyDocuments), "MyDoc.txt");

		// Create the file if it does not exist.
		if (!File.Exists(fileLoc))
		{
			using (StreamWriter swNew = new StreamWriter(fileLoc))
			{
				swNew.WriteLine("Sample text");
			}
		}

		// Display the contents in a TextBox.
		using (StreamReader sr = new StreamReader(fileLoc))
		{
			inputData.Text = sr.ReadToEnd();
			inputData.Visibility = Visibility.Visible;
		}
	}
}


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.