信息
您所需的主题如下所示。但此主题未包含在此库中。

File 类

2013/12/13

提供用于创建、复制、删除、移动和打开文件的静态方法,并协助创建 FileStream 对象。

Namespace:  System.IO
程序集:  mscorlib(位于 mscorlib.dll 中)

声明
Public NotInheritable Class File

File 类型公开以下成员。

  名称说明
公共方法静态成员AppendText创建一个 StreamWriter,它将 UTF-8 编码文本追加到现有文件。
公共方法静态成员Copy(String, String)将现有文件复制到新文件。不允许覆盖同名的文件。
公共方法静态成员Copy(String, String, Boolean)将现有文件复制到新文件。允许覆盖同名的文件。
公共方法静态成员Create(String)在指定路径中创建或覆盖文件。
公共方法静态成员Create(String, Int32)创建或覆盖指定的文件。
公共方法静态成员CreateText创建或打开一个文件用于写入 UTF-8 编码的文本。
公共方法静态成员Delete删除指定的文件。如果指定的文件不存在,则不引发异常。
公共方法静态成员Exists确定指定的文件是否存在。
公共方法静态成员GetCreationTime返回指定文件或目录的创建日期和时间。
公共方法静态成员GetLastAccessTime返回上次访问指定文件或目录的日期和时间。
公共方法静态成员GetLastWriteTime返回上次写入指定文件或目录的日期和时间。
公共方法静态成员Move将指定文件移到新位置,并提供指定新文件名的选项。
公共方法静态成员Open(String, FileMode)打开指定路径上的 FileStream,具有读/写访问权限。
公共方法静态成员Open(String, FileMode, FileAccess)以指定的模式和访问权限打开指定路径上的 FileStream
公共方法静态成员Open(String, FileMode, FileAccess, FileShare)打开指定路径上的 FileStream,具有指定的读、写或读/写访问模式以及指定的共享选项。
公共方法静态成员OpenRead打开现有文件以进行读取。
公共方法静态成员OpenText打开现有 UTF-8 编码文本文件以进行读取。
公共方法静态成员OpenWrite打开现有文件以进行写入。
公共方法静态成员SetAttributes安全非常关键。 设置指定路径上文件的指定 FileAttributes
返回顶部

File 类用于典型的操作,如复制、移动、重命名、创建、打开、删除和追加到文件。也可将 File 类用于获取和设置文件特性或有关文件创建、访问及写入操作的 DateTime 信息。

许多 File 方法在您创建或打开文件时返回其他 I/O 类型。可以使用这些其他类型进一步处理文件。有关更多信息,请参见特定的 File 成员,如 OpenTextCreateTextCreate

由于所有的 File 方法都是静态的,所以如果只想执行一个操作,那么使用 File 方法的效率比使用相应的 FileInfo 实例方法可能更高。所有的 File 方法都要求当前所操作的文件的路径。

File 类的静态方法对所有方法都执行安全检查。如果打算多次重用某个对象,可考虑改用 FileInfo 的相应实例方法,因为并不总是需要安全检查。

下表描述了用于自定义各种 File 方法的行为的枚举。

枚举

说明

FileAccess

指定对文件的读取和写入访问。

FileShare

为已在使用中的文件指定允许的访问级别。

FileMode

指定是保留还是覆盖现有文件的内容,并指定创建现有文件的请求是否会导致异常。

说明注意:

在接受路径作为输入字符串的成员中,路径必须是格式良好的,否则将引发异常。例如,如果路径是完全限定的但以空格开头,则路径在类的方法中不会被修剪。因此,路径的格式不正确,并将引发异常。同样,路径或路径的组合不能被完全限定两次。例如,“c:\temp c:\windows”在大多数情况下也将引发异常。在使用接受路径字符串的方法时,请确保路径是格式良好的。

版本说明

Windows Phone

此类型的存在是为了支持 Windows Phone 中的 .NET Compact Framework 基础结构,并不适用于应用程序代码。

下面的示例使用 File 来确定用户的“我的文档”文件夹中是否有文件存在。此代码示例摘自一个为 StreamReader 类提供的更大示例。


Private Sub OpenFile_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)

	
		' fileLoc is a global string variable.
		fileLoc = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "MyDoc.txt")

		' Create the file if it does not exist.
		If Not File.Exists(fileLoc) Then
			Using swNew As New StreamWriter(fileLoc)
				swNew.WriteLine("Sample text")
			End Using
		End If

		' Display the contents in a TextBox.
		Using sr As New StreamReader(fileLoc)
			inputData.Text = sr.ReadToEnd()
			inputData.Visibility = Visibility.Visible
		End Using
End Sub


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示: