本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

File 類別

 

提供建立、複製、刪除、移動和開啟單一檔案的靜態方法,並協助 FileStream 物件的建立。

若要瀏覽此類型的.NET Framework 原始程式碼,請參閱 Reference Source

命名空間:   System.IO
組件:  mscorlib (於 mscorlib.dll)

System.Object
  System.IO.File

[ComVisibleAttribute(true)]
public static class File

名稱描述
System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>)

在檔案中加入幾行內容,然後關閉檔案。 如果指定的檔案不存在,則這個方法會建立檔案,將指定的程式行寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>, Encoding)

使用指定編碼將指定的幾行內容加入檔案,然後關閉檔案。 如果指定的檔案不存在,則這個方法會建立檔案,將指定的程式行寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String)

開啟檔案,將指定的字串附加至檔案,然後關閉檔案。 如果檔案不存在,則這個方法會建立檔案,將指定的字串寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String, Encoding)

將指定字串附加至檔案,如果檔案不存在,請建立一個新檔案。

System_CAPS_pubmethodSystem_CAPS_staticAppendText(String)

建立會將 UTF-8 編碼的文字附加至現有檔案或新檔案 (如果指定的檔案不存在) 的 StreamWriter

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String)

複製現有的檔案到新的檔案。 不允許覆寫相同名稱的檔案。

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String, Boolean)

複製現有的檔案到新的檔案。 允許覆寫相同名稱的檔案。

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

在指定的路徑中建立或覆寫檔案。

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32)

建立或覆寫指定檔案。

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions)

建立或覆寫指定檔案,並指定緩衝區大小以及描述如何建立或覆寫檔案的 FileOptions 值。

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions, FileSecurity)

建立或覆寫具有指定緩衝區大小、檔案選項和檔案安全性的指定檔案。

System_CAPS_pubmethodSystem_CAPS_staticCreateText(String)

建立或開啟用以寫入 UTF-8 編碼文字的檔案。

System_CAPS_pubmethodSystem_CAPS_staticDecrypt(String)

解密目前帳戶使用 Encrypt 方法加密的檔案。

System_CAPS_pubmethodSystem_CAPS_staticDelete(String)

刪除指定的檔案。

System_CAPS_pubmethodSystem_CAPS_staticEncrypt(String)

加密檔案,只有使用加密檔案的帳戶才能將其解密。

System_CAPS_pubmethodSystem_CAPS_staticExists(String)

判斷指定的檔案是否存在。

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String)

取得 FileSecurity 物件,該物件封裝指定檔案的存取控制清單 (ACL) 項目。

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String, AccessControlSections)

取得 FileSecurity 物件,該物件會封裝特定檔案之指定類型的存取控制清單 (ACL) 項目。

System_CAPS_pubmethodSystem_CAPS_staticGetAttributes(String)

取得路徑上檔案的 FileAttributes

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTime(String)

傳回指定檔案或目錄的建立日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTimeUtc(String)

傳回指定檔案或目錄的建立日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTime(String)

傳回指定檔案或目錄上次被存取的日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTimeUtc(String)

傳回指定檔案或目錄上次被存取的日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTime(String)

傳回指定檔案或目錄上次被寫入的日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTimeUtc(String)

傳回指定檔案或目錄上次被寫入的日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticMove(String, String)

移動指定的檔案至新的位置,提供指定新檔名的選項。

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode)

在指定路徑上以讀取/寫入存取來開啟 FileStream

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess)

在指定路徑上以指定模式和存取來開啟 FileStream

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess, FileShare)

在指定路徑上開啟 FileStream,假定它具有讀取、寫入或讀取/寫入存取的指定模式和指定的共用選項。

System_CAPS_pubmethodSystem_CAPS_staticOpenRead(String)

開啟現有檔案來讀取。

System_CAPS_pubmethodSystem_CAPS_staticOpenText(String)

開啟現有 UTF-8 編碼的文字檔來讀取。

System_CAPS_pubmethodSystem_CAPS_staticOpenWrite(String)

開啟現有檔案或建立新檔案,以進行寫入。

System_CAPS_pubmethodSystem_CAPS_staticReadAllBytes(String)

開啟二進位檔案,將檔案內容讀入位元組陣列,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String)

開啟文字檔,讀取檔案的所有行,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String, Encoding)

開啟檔案,以指定的編碼方式讀取檔案的所有行,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String)

開啟文字檔,讀取檔案的所有行,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String, Encoding)

開啟檔案,以指定的編碼方式讀取檔案的所有行,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String)

讀取檔案的所有行。

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String, Encoding)

讀取具有指定編碼方式的檔案所有行。

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String)

用另一個檔案的內容取代指定檔案的內容,刪除原始檔案並建立已取代檔案的備份。

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String, Boolean)

用另一個檔案的內容取代指定檔案的內容,刪除原始檔案,建立已取代檔案的備份,並選擇性地忽略合併錯誤。

System_CAPS_pubmethodSystem_CAPS_staticSetAccessControl(String, FileSecurity)

FileSecurity 物件描述的存取控制清單 (ACL) 項目套用至指定的檔案。

System_CAPS_pubmethodSystem_CAPS_staticSetAttributes(String, FileAttributes)

在指定路徑上設定檔案的指定 FileAttributes

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTime(String, DateTime)

設定檔案建立的日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTimeUtc(String, DateTime)

設定檔案建立的日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTime(String, DateTime)

設定指定檔案上一次被存取的日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTimeUtc(String, DateTime)

設定指定檔案上次被存取的日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTime(String, DateTime)

設定指定檔案上次被寫入的日期和時間。

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTimeUtc(String, DateTime)

設定指定檔案上次寫入的日期和時間,格式為國際標準時間 (UTC)。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllBytes(String, Byte[])

建立新檔案,將指定的位元組陣列寫入檔案,然後關閉檔案。 如果檔案已經存在,則會覆寫該檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>)

建立新檔案,並於檔案中寫入字串的集合,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>, Encoding)

使用指定編碼方式建立新檔案,並將字串的集合寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[])

建立新檔案,將指定的字串陣列寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[], Encoding)

建立新檔案,使用指定的編碼方式將指定的字串陣列寫入檔案,然後關閉檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String)

建立新檔案,將指定的字串寫入檔案,然後關閉檔案。 如果檔案已經存在,則會覆寫該檔案。

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String, Encoding)

建立新檔案,使用指定的編碼方式將指定的字串寫入檔案,然後關閉檔案。 如果檔案已經存在,則會覆寫該檔案。

System_CAPS_note注意

若要檢視此類型的.NET Framework 原始程式碼,請參閱 Reference Source 您可以瀏覽原始碼、 下載的離線,參考並逐步執行 (包含修補程式和更新),在偵錯。see instructions.

使用 File 類別一般作業,例如複製、 移動、 重新命名、 建立、 開啟、 刪除和附加至單一檔案一次。 您也可以使用 File 類別來取得和設定檔屬性或 DateTime 相關的資訊來建立、 存取和寫入檔案。 如果您想要在多個檔案上執行作業,請參閱 Directory.GetFilesDirectoryInfo.GetFiles

許多 File 方法會傳回其他 I/O 類型,當您建立或開啟檔案。 您可以使用這些其他型別來進一步操作檔案。 如需詳細資訊,請參閱特定 File 成員,例如 OpenText, ,CreateText, ,或 Create

因為所有 File 方法是靜態的則可能會更有效使用 File 方法,而非對應 FileInfo 執行個體方法,如果您想要執行一個動作。 所有 File 方法需要您操作檔案的路徑。

靜態方法 File 類別執行的所有方法上的安全性檢查。 如果您要重複使用的物件數次,請考慮使用對應的執行個體方法的 FileInfo 相反地,因為安全性檢查會不一定有必要。

根據預設,新檔案的完整讀寫存取是授與所有使用者。

下表說明用於自訂的各種行為的列舉型別 File 方法。

列舉

描述

FileAccess

指定讀取和寫入檔案的存取權。

FileShare

指定允許的使用中檔案的存取層級。

FileMode

指定是否保留或覆寫現有檔案的內容和建立現有檔案的要求是否導致例外狀況。

System_CAPS_note注意

在接受路徑,做為輸入字串的成員,該路徑必須是格式正確或發生例外狀況。 比方說,如果路徑是完整名稱,但開頭有空格,路徑中類別的方法不修剪。 因此,路徑的格式不正確,而且會引發例外狀況。 同樣地,路徑的組合無法完整限定兩次。 例如,"c:\temp c:\windows 」 也會引發例外狀況在大部分情況下。 請確定您的路徑是語式正確的當您使用接受路徑字串的方法。

在接受路徑的成員,路徑可以參考到檔案或只是一個目錄。 指定的路徑也可以參考的相對路徑或通用命名慣例 (UNC) 路徑的伺服器和共用名稱。 例如,下列所有條件都是可接受的路徑︰

  • 在 C# 中的 「 c:\\MyDir\\MyFile.txt 」 或者 「 c:\MyDir\MyFile.txt 」 在 Visual Basic 中。

  • 在 C# 中的 「 c:\\MyDir 」 或者 「 c:\MyDir 」 在 Visual Basic 中。

  • 「 MyDir\\MySubdir 」 以 C# 或 Visual Basic 中的 「 MyDir\MySubDir 」。

  • 在 C# 中的 「 \\\MyServer\\MyShare 」 或者 「 \\MyServer\MyShare 」 在 Visual Basic 中。

如需一般 I/O 工作的清單,請參閱 一般 I/O 工作

下列範例示範如何使用 File 類別來檢查是否已存在的檔案,並根據結果,請建立新的檔案和寫入,或開啟現有的檔案並從佇列讀取。 執行程式碼之前,請先建立 c:\temp 資料夾。

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

通用 Windows 平台
自 10 起供應
.NET Framework
自 1.1 起供應
Silverlight
自 2.0 起供應
Windows Phone Silverlight
自 7.0 起供應

此類型的任何 public static (在 Visual Basic 中 共用 在 Visual Basic 中) 成員皆為安全執行緒。不保證任何執行個體成員為安全執行緒。

回到頁首
顯示: