System.IO中File类(单个文件操作)中的方法介绍
一、File类定义
命名空间:Sytem.IO
程序集:System.Runtime.dll
提供用于创建、复制、删除、移动和打开单一文件的静态方法,并协助创建FileStream对象。
二、File类方法
AppendAllLines(String, IEnumerable<String>) 向一个文件中追加行,然后关闭该文件。 如果指定文件不存在,此方法会创建一个文件,向其中写入指定的行,然后关闭该文件。
String:要向其中追加行的文件。 如果文件尚不存在,则创建该文件。
IEnumerable<String>:要追加到文件中的行。
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)以异步形式向一个文件中追加行,然后关闭该文件。 如果指定文件不存在,此方法会创建一个文件,向其中写入指定的行,然后关闭该文件
重载:AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)
使用指定的编码以异步形式向一个文件中追加行,然后关闭该文件。 如果指定文件不存在,此方法会创建一个文件,向其中写入指定的行,然后关闭该文件。
String:要向其中追加行的文件。 如果文件尚不存在,则创建该文件。
IEnumerable<String>:要追加到文件中的行。
Encoding:要使用的字符编码。
CancellationToken:要监视取消请求的标记。 默认值是 None。
AppendAllText(String, String) 打开一个文件,向其中追加指定的字符串,然后关闭该文件。 如果文件不存在,此方法将创建一个文件,将指定的字符串写入文件,然后关闭该文件。
重载:AppendAllTextAsync(String, String, CancellationToken)
以异步方式打开文件或创建文件(如果文件尚不存在),将指定的字符串追加到该文件,然后关闭文件。
string:要将指定的字符串追加到的文件
string:要追加到文件中的字符串
CancellationToken:要监视取消请求的标记,默认值是None。
AppendText(String) 创建一个 StreamWriter,它将 UTF-8 编码文本追加到现有文件或新文件(如果指定文件不存在)。
string:要向其中追加内容的文件的路径 例子:将txt文本追加到新的文件中
Copy(String, String) 将现有文件复制到新文件。(不允许覆盖同名文件)
重载:Copy(String, String,Boolean)
将现有文件复制到新文件。(允许覆盖同名文件)
参数1:要复制的文件
参数2:目标文件名称
参数3:true或者fales
Create(String) 在指定路径中创建或覆盖文件。
参数1:要创建的文件的路径及名称。
重载1:Create(String, Int32)
在指定路径中创建或覆盖文件,指定缓冲区大小。
重载2:Create(String, Int32, FileOptions)
创建或覆盖指定路径中的文件,指定缓冲区大小和一个描述如何创建或覆盖该文件的选项。
参数2:用于读取和写入到文件的已放入缓冲区的字节数。
参数3:FileOptions 值之一,它描述如何创建或覆盖该文件。
CreateSymbolicLink(String, String):创建由 path 该指向 pathToTarget的文件符号链接。
参数1:应在其中创建符号链接的路径。
参数2:符号链接指向的目标的路径。
CreateText(string)创建或打开用于写入 UTF-8 编码文本的文件。 如果该文件已存在,将覆盖其内容。
参数:要打开以进行写入的文件。
Decrypt(string)使用 Encrypt(String) 方法解密由当前帐户加密的文件。
参数:描述要解密的文件的路径。
Delete(string)删除指定的文件。
要删除的文件的名称。 不支持通配符。
Encrypt(string)将某个文件加密,使得只有加密该文件的帐户才能将其解密。
参数:描述要加密的文件的路径。
Exists(string)确定指定的文件是否存在。
参数:文件路径 例子:"c:\temp\test.txt"
Exists(string)确定指定的文件是否存在。
参数:文件路径 例子:"c:\temp\test.txt"
GetCreationTime(stirng)返回指定文件或目录的创建日期和时间。
参数:要获取其创建日期和时间信息的文件或目录。
GetLastAccessTime(string)返回上次访问指定文件或目录的日期和时间。
参数:要获取其访问日期和时间信息的文件或目录。
GetLastWriteTime(string)返回上次写入指定文件或目录的日期和时间。
参数:要获取其写入日期和时间信息的文件或目录。”
Move 将指定文件移到新位置,提供要指定新文件名的选项。
重载:Move(String,String,Boolean)
参数1:要移动的文件的名称。 可以包括相对或绝对路径。
参数2:文件的新路径和名称。
参数3:true或者fales
Open(string,fileMode) 通过不共享的读/写访问权限打开指定路径上的 FileStream。
参数1:要打开的文件。
参数2:FileMode 值,用于指定在文件不存在时是否创建该文件,并确定是保留还是覆盖现有文件的内容。
重载:Open(string,FileStreamOptions)
参数1:要打开的文件
参数2:描述要使用的可选 FileStream 参数的对象。
重载:Open(String, FileMode, FileAccess)
重载:Open(String, FileMode, FileAccess, FileShare)
参数1:要打开的文件
参数2:FileMode 值,用于指定在文件不存在时是否创建该文件,并确定是保留还是覆盖现有文件的内容。
参数3:一个 FileAccess 值,它指定可以对文件执行的操作。
参数4:一个 FileShare 值,它指定其他线程所具有的对该文件的访问类型。
OpenHandle(string,filMode,fileAccess,fileShare,fileOptions,int64) 使用指定的路径、创建模式、读/写和共享权限初始化类的新实例 SafeFileHandle ,其他 SafeFileHandles 的访问权限可以具有相同的文件、其他文件选项和分配大小。
参数1:当前 SafeFileHandle 实例将封装的文件的相对路径或绝对路径。
参数2:用于确定文件的打开或创建方式的枚举值之一。 默认值为 Open
参数3:枚举值的按位组合,用于确定如何访问文件。 默认值为 Read
参数4:枚举值的按位组合,这些枚举值确定进程共享文件的方式。 默认值为 Read。
参数5:描述要使用的可选 SafeFileHandle 参数的对象。
参数6:文件的初始分配大小(以字节为单位)。 仅当正在创建、覆盖或替换常规文件时,正值才有效。 不允许使用负值。 在其他情况下, (包括默认 0 值) ,则忽略该值。
OpenRead(string)打开现有文件以进行读取。
参数:要打开以进行读取的文件。
OpenText(string) 打开现有 UTF-8 编码文本文件以进行读取。
参数:要打开已进行读取的文件
OpenWrite(string)打开一个现有文件或创建一个新文件以进行写入。
参数:要打开以进行写入的文件。
ReadLines(string)读取文件的行
重载:ReadLines
读取具有指定编码的文件的行
参数:要读取的文件
参数2:应用到文件内容的编码。
Replace(string,string,string)使用其他文件的内容替换指定文件的内容,这一过程将删除原始文件,并创建被替换文件的备份。
重载:Replace(string,string,string,Boolean)
参数1:替换由destinationFileName
指定的文件的文件名
参数2:被替换文件的名称。
参数3:备份文件的名称。
参数4:如果忽略从被替换文件到替换文件的合并错误(如特性和访问控制列表 (ACL)),则为true
,否则为false
。
SetAttributes(string,FileAttibutes)获取指定路径上的文件的指定 FileAttributes。
参数1:文件的路径。
参数2:枚举值的安位组合
SetCreationTime(string,DateTime)设置创建该文件的日期和时间。
参数1:要设置其创建日期和时间信息的文件。
参数2:一个 DateTime,它包含要为path
的创建日期和时间设置的值。 该值用本地时间表示。