//建立一個新檔案，向其中寫入指定的字元串，然後關閉檔案。 如果目标檔案已存在，則覆寫該檔案。
System.IO.File.WriteAllText("d:\\cdb_user_update_password.txt", "武松打虎");
//打開一個檔案，向其中追加指定的字元串，然後關閉該檔案。
//如果檔案不存在，此方法将建立一個檔案，将指定的字元串寫入檔案，然後關閉該檔案。
System.IO.File.AppendAllText("d:\\test2.txt", "霍去病");
//打開一個文本檔案，讀取檔案的所有行，然後關閉該檔案。
string content=System.IO.File.ReadAllText("d:\\test2.txt");
namespace System.IO
{
//
// 摘要:
// 提供用于建立、複制、删除、移動和打開單一檔案的靜态方法，并協助建立 System.IO.FileStream 對象。 若要浏覽此類型的.NET Framework
// 源代碼，請參閱 Reference Source。
[ComVisible(true)]
public static class File
{
//
// 摘要:
// 向一個檔案中追加行，然後關閉該檔案。 如果指定檔案不存在，此方法會建立一個檔案，向其中寫入指定的行，然後關閉該檔案。
//
// 參數:
// path:
// 要向其中追加行的檔案。 如果檔案尚不存在，則建立該檔案。
//
// contents:
// 要追加到檔案中的行。
//
// 異常:
// T:System.ArgumentException:
// path 為長度為零的字元串，僅包含空白，或包含 System.IO.Path.GetInvalidPathChars 方法定義的一個或多個無效字元。
//
// T:System.ArgumentNullException:
// path 或 contents 之一是 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，目錄不存在或在未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有寫入到檔案中的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。
public static void AppendAllLines(string path, IEnumerable<string> contents);
//
// 摘要:
// 使用指定的編碼向一個檔案中追加行，然後關閉該檔案。 如果指定檔案不存在，此方法會建立一個檔案，向其中寫入指定的行，然後關閉該檔案。
//
// 參數:
// path:
// 要向其中追加行的檔案。 如果檔案尚不存在，則建立該檔案。
//
// contents:
// 要追加到檔案中的行。
//
// encoding:
// 要使用的字元編碼。
//
// 異常:
// T:System.ArgumentException:
// path 為長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.GetInvalidPathChars 方法定義的無效字元。
//
// T:System.ArgumentNullException:
// path、contents 或 encoding 為 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，目錄不存在或在未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。 - 或 - 調用方沒有所要求的權限。
public static void AppendAllLines(string path, IEnumerable<string> contents, Encoding encoding);
//
// 摘要:
// 将指定的字元串追加到檔案中，如果檔案還不存在則建立該檔案。
//
// 參數:
// path:
// 要将指定的字元串追加到的檔案。
//
// contents:
// 要追加到檔案中的字元串。
//
// encoding:
// 要使用的字元編碼。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，目錄不存在或在未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static void AppendAllText(string path, string contents, Encoding encoding);
//
// 摘要:
// 打開一個檔案，向其中追加指定的字元串，然後關閉該檔案。 如果檔案不存在，此方法将建立一個檔案，将指定的字元串寫入檔案，然後關閉該檔案。
//
// 參數:
// path:
// 要将指定的字元串追加到的檔案。
//
// contents:
// 要追加到檔案中的字元串。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，目錄不存在或在未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static void AppendAllText(string path, string contents);
//
// 摘要:
// 建立一個 System.IO.StreamWriter，它将 UTF-8 編碼文本追加到現有檔案或新檔案（如果指定檔案不存在）。
//
// 參數:
// path:
// 要向其中追加内容的檔案的路徑。
//
// 傳回結果:
// 一個流寫入器，它将 UTF-8 編碼文本追加到指定檔案或新檔案。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，目錄不存在或在未映射的驅動器上）。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static StreamWriter AppendText(string path);
//
// 摘要:
// 将現有檔案複制到新檔案。 不允許覆寫同名的檔案。
//
// 參數:
// sourceFileName:
// 要複制的檔案。
//
// destFileName:
// 目标檔案的名稱。 它不能是一個目錄或現有檔案。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars
// 定義的無效字元。 - 或 - sourceFileName 或 destFileName 指定目錄。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 sourceFileName。
//
// T:System.IO.IOException:
// destFileName 已存在。 - 或 - 發生了 I/O 錯誤。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式無效。
public static void Copy(string sourceFileName, string destFileName);
//
// 摘要:
// 将現有檔案複制到新檔案。 允許覆寫同名的檔案。
//
// 參數:
// sourceFileName:
// 要複制的檔案。
//
// destFileName:
// 目标檔案的名稱。 不能是目錄。
//
// overwrite:
// 如果可以覆寫目标檔案，則為 true；否則為 false。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - destFileName 是隻讀。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars
// 定義的無效字元。 - 或 - sourceFileName 或 destFileName 指定目錄。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 sourceFileName。
//
// T:System.IO.IOException:
// destFileName 存在且 overwrite 是 false。 - 或 - 發生了 I/O 錯誤。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式無效。
public static void Copy(string sourceFileName, string destFileName, bool overwrite);
//
// 摘要:
// 在指定路徑中建立或覆寫檔案。
//
// 參數:
// path:
// 要建立的檔案的路徑及名稱。
//
// 傳回結果:
// 一個 System.IO.FileStream，它提供對 path 中指定的檔案的讀/寫通路。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 建立檔案時發生 I/O 錯誤。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Create(string path);
//
// 摘要:
// 建立或覆寫指定的檔案。
//
// 參數:
// path:
// 檔案的名稱。
//
// bufferSize:
// 用于讀取和寫入到檔案的已放入緩沖區的位元組數。
//
// 傳回結果:
// 一個具有指定緩沖區大小的 System.IO.FileStream，它提供對 path 中指定的檔案的讀/寫通路。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 建立檔案時發生 I/O 錯誤。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Create(string path, int bufferSize);
//
// 摘要:
// 建立或覆寫指定的檔案，指定緩沖區大小和一個描述如何建立或覆寫該檔案的 System.IO.FileOptions 值。
//
// 參數:
// path:
// 檔案的名稱。
//
// bufferSize:
// 用于讀取和寫入到檔案的已放入緩沖區的位元組數。
//
// options:
// System.IO.FileOptions 值之一，它描述如何建立或覆寫該檔案。
//
// 傳回結果:
// 具有指定緩沖區大小的新檔案。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。 - 或 - 為 options 指定了 System.IO.FileOptions.Encrypted，但目前平台不支援檔案加密。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 建立檔案時發生 I/O 錯誤。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Create(string path, int bufferSize, FileOptions options);
//
// 摘要:
// 建立或覆寫具有指定的緩沖區大小、檔案選項和檔案安全性的指定檔案。
//
// 參數:
// path:
// 檔案的名稱。
//
// bufferSize:
// 用于讀取和寫入到檔案的已放入緩沖區的位元組數。
//
// options:
// System.IO.FileOptions 值之一，它描述如何建立或覆寫該檔案。
//
// fileSecurity:
// System.Security.AccessControl.FileSecurity 值之一，它确定檔案的通路控制和稽核安全性。
//
// 傳回結果:
// 具有指定的緩沖區大小、檔案選項和檔案安全性的新檔案。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。 - 或 - 為 options 指定了 System.IO.FileOptions.Encrypted，但目前平台不支援檔案加密。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定了一個隻讀檔案。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 建立檔案時發生 I/O 錯誤。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Create(string path, int bufferSize, FileOptions options, FileSecurity fileSecurity);
//
// 摘要:
// 建立或打開用于寫入 UTF-8 編碼文本的檔案。
//
// 參數:
// path:
// 要打開以進行寫入的檔案。
//
// 傳回結果:
// 一個 System.IO.StreamWriter，它使用 UTF-8 編碼寫入到指定的檔案。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static StreamWriter CreateText(string path);
//
// 摘要:
// 使用 System.IO.File.Encrypt(System.String) 方法解密由目前帳戶加密的檔案。
//
// 參數:
// path:
// 描述要解密的檔案的路徑。
//
// 異常:
// T:System.ArgumentException:
// path 參數為長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 參數為 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了無效的驅動器。
//
// T:System.IO.FileNotFoundException:
// 找不到 path 參數描述的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。 例如，加密檔案已打開。 - 或 - 目前平台不支援此操作。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.PlatformNotSupportedException:
// 目前作業系統不是 Windows NT 或更高版本。
//
// T:System.NotSupportedException:
// 檔案系統不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// path 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 參數指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void Decrypt(string path);
//
// 摘要:
// 删除指定的檔案。
//
// 參數:
// path:
// 要删除的檔案的名稱。 該指令不支援通配符。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 指定的檔案正在使用。 - 或 - 在檔案中存在開放句柄，并且作業系統是 Windows XP 或更早的版本。 枚舉目錄和檔案可能會導緻此開放句柄出現。 有關詳細資訊，請參閱如何：枚舉目錄和檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - 該檔案是正在使用的可執行檔案。 - 或 - path 是一個目錄。 - 或 - path 指定了一個隻讀檔案。
[SecuritySafeCritical]
public static void Delete(string path);
//
// 摘要:
// 将某個檔案加密，使得隻有加密該檔案的帳戶才能将其解密。
//
// 參數:
// path:
// 描述要加密的檔案的路徑。
//
// 異常:
// T:System.ArgumentException:
// path 參數為長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 參數為 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了無效的驅動器。
//
// T:System.IO.FileNotFoundException:
// 找不到 path 參數描述的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。 - 或 - 目前平台不支援此操作。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.PlatformNotSupportedException:
// 目前作業系統不是 Windows NT 或更高版本。
//
// T:System.NotSupportedException:
// 檔案系統不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// path 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 參數指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void Encrypt(string path);
//
// 摘要:
// 确定指定的檔案是否存在。
//
// 參數:
// path:
// 要檢查的檔案。
//
// 傳回結果:
// 如果調用方具有要求的權限并且 true 包含現有檔案的名稱，則為 path；否則為 false。 如果 false 為 path（一個無效路徑或零長度字元串）,則此方法也将傳回
// null。 如果調用方不具有讀取指定檔案所需的足夠權限，則不引發異常并且該方法傳回 false，這與 path 是否存在無關。
[SecuritySafeCritical]
public static bool Exists(string path);
//
// 摘要:
// 擷取一個 System.Security.AccessControl.FileSecurity 對象，它封裝指定檔案的通路控制清單 (ACL) 條目。
//
// 參數:
// path:
// 一個檔案的路徑，該檔案包含描述檔案的通路控制清單 (ACL) 資訊的 System.Security.AccessControl.FileSecurity
// 對象。
//
// 傳回結果:
// 一個 System.Security.AccessControl.FileSecurity 對象，它封裝由 path 參數描述的檔案的通路控制規則。
//
// 異常:
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.Runtime.InteropServices.SEHException:
// path 參數為 null。
//
// T:System.SystemException:
// 找不到檔案。
//
// T:System.UnauthorizedAccessException:
// path 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 參數指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
public static FileSecurity GetAccessControl(string path);
//
// 摘要:
// 擷取一個 System.Security.AccessControl.FileSecurity 對象，封裝特定檔案的指定類型的通路控制清單 (ACL) 項。
//
// 參數:
// path:
// 一個檔案的路徑，該檔案包含描述檔案的通路控制清單 (ACL) 資訊的 System.Security.AccessControl.FileSecurity
// 對象。
//
// includeSections:
// System.Security.AccessControl.AccessControlSections 值之一，它指定要接收的通路控制清單 (ACL) 資訊的類型。
//
// 傳回結果:
// 一個 System.Security.AccessControl.FileSecurity 對象，它封裝由 path 參數描述的檔案的通路控制規則。
//
// 異常:
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.Runtime.InteropServices.SEHException:
// path 參數為 null。
//
// T:System.SystemException:
// 找不到檔案。
//
// T:System.UnauthorizedAccessException:
// path 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 參數指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
public static FileSecurity GetAccessControl(string path, AccessControlSections includeSections);
//
// 摘要:
// 擷取在此路徑上的檔案的 System.IO.FileAttributes。
//
// 參數:
// path:
// 檔案的路徑。
//
// 傳回結果:
// 路徑上檔案的 System.IO.FileAttributes。
//
// 異常:
// T:System.ArgumentException:
// path 為空，僅包含空格，或包含無效字元。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.IO.FileNotFoundException:
// path 表示一個檔案且它是無效的，例如，位于未映射的驅動器上或找不到該檔案。
//
// T:System.IO.DirectoryNotFoundException:
// path 表示一個目錄且它是無效的，例如，位于未映射的驅動器上或找不到該目錄。
//
// T:System.IO.IOException:
// 此檔案正由另一個程序使用。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static FileAttributes GetAttributes(string path);
//
// 摘要:
// 傳回指定檔案或目錄的建立日期和時間。
//
// 參數:
// path:
// 要擷取其建立日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為指定檔案或目錄的建立日期和時間。 該值用本地時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetCreationTime(string path);
//
// 摘要:
// 傳回指定的檔案或目錄的建立日期及時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要擷取其建立日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為指定檔案或目錄的建立日期和時間。 該值用 UTC 時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetCreationTimeUtc(string path);
//
// 摘要:
// 傳回上次通路指定檔案或目錄的日期和時間。
//
// 參數:
// path:
// 要擷取其通路日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為上次通路指定檔案或目錄的日期和時間。 該值用本地時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetLastAccessTime(string path);
//
// 摘要:
// 傳回上次通路指定的檔案或目錄的日期及時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要擷取其通路日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為上次通路指定檔案或目錄的日期和時間。 該值用 UTC 時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetLastAccessTimeUtc(string path);
//
// 摘要:
// 傳回上次寫入指定檔案或目錄的日期和時間。
//
// 參數:
// path:
// 要擷取其寫入日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為上次寫入指定檔案或目錄的日期和時間。 該值用本地時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetLastWriteTime(string path);
//
// 摘要:
// 傳回上次寫入指定的檔案或目錄的日期和時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要擷取其寫入日期和時間資訊的檔案或目錄。
//
// 傳回結果:
// 一個 System.DateTime 結構，它被設定為上次寫入指定檔案或目錄的日期和時間。 該值用 UTC 時間表示。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static DateTime GetLastWriteTimeUtc(string path);
//
// 摘要:
// 将指定檔案移到新位置，提供要指定新檔案名的選項。
//
// 參數:
// sourceFileName:
// 要移動的檔案的名稱。 可以包括相對或絕對路徑。
//
// destFileName:
// 檔案的新路徑和名稱。
//
// 異常:
// T:System.IO.IOException:
// 目标檔案已存在。 - 或 - 未找到 sourceFileName。
//
// T:System.ArgumentNullException:
// sourceFileName 或 destFileName 為 null。
//
// T:System.ArgumentException:
// sourceFileName 或 destFileName 為長度為零的字元串，僅包含空格，或包含在 System.IO.Path.InvalidPathChars
// 中定義無效字元。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// sourceFileName 或 destFileName 中指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.NotSupportedException:
// sourceFileName 或 destFileName 的格式無效。
[SecuritySafeCritical]
public static void Move(string sourceFileName, string destFileName);
//
// 摘要:
// 打開指定路徑上的 System.IO.FileStream，具有帶讀、寫或讀/寫通路的指定模式和指定的共享選項。
//
// 參數:
// path:
// 要打開的檔案。
//
// mode:
// System.IO.FileMode 值，用于指定在檔案不存在時是否建立該檔案，并确定是保留還是覆寫現有檔案的内容。
//
// access:
// 一個 System.IO.FileAccess 值，它指定可以對檔案執行的操作。
//
// share:
// 一個 System.IO.FileShare 值，它指定其他線程所具有的對該檔案的通路類型。
//
// 傳回結果:
// 指定路徑上的 System.IO.FileStream，具有帶讀、寫或讀/寫通路的指定模式以及指定的共享選項。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。 - 或
// - access 指定了 Read，并且 mode 指定了 Create、CreateNew、Truncate 或 Append。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案，并且 access 不是 Read。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。 - 或
// - mode 為 System.IO.FileMode.Create，且指定的檔案是一個隐藏檔案。
//
// T:System.ArgumentOutOfRangeException:
// mode、access 或 share 指定了一個無效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Open(string path, FileMode mode, FileAccess access, FileShare share);
//
// 摘要:
// 以讀/寫通路權限打開指定路徑上的 System.IO.FileStream。
//
// 參數:
// path:
// 要打開的檔案。
//
// mode:
// System.IO.FileMode 值，用于指定在檔案不存在時是否建立該檔案，并确定是保留還是覆寫現有檔案的内容。
//
// 傳回結果:
// 以讀/寫通路與不共享權限打開的指定模式和路徑上的 System.IO.FileStream。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。 - 或
// - mode 為 System.IO.FileMode.Create，且指定的檔案是一個隐藏檔案。
//
// T:System.ArgumentOutOfRangeException:
// mode 指定了一個無效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Open(string path, FileMode mode);
//
// 摘要:
// 以指定的模式和通路權限打開指定路徑上的 System.IO.FileStream。
//
// 參數:
// path:
// 要打開的檔案。
//
// mode:
// System.IO.FileMode 值，用于指定在檔案不存在時是否建立該檔案，并确定是保留還是覆寫現有檔案的内容。
//
// access:
// 一個 System.IO.FileAccess 值，它指定可以對檔案執行的操作。
//
// 傳回結果:
// 一個非共享的 System.IO.FileStream，它提供對指定檔案的通路，并且具有指定的模式和通路權限。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。 - 或
// - access 指定了 Read，并且 mode 指定了 Create、CreateNew、Truncate 或 Append。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案，并且 access 不是 Read。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。 - 或
// - mode 為 System.IO.FileMode.Create，且指定的檔案是一個隐藏檔案。
//
// T:System.ArgumentOutOfRangeException:
// mode 或 access 指定了一個無效值。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream Open(string path, FileMode mode, FileAccess access);
//
// 摘要:
// 打開現有檔案以進行讀取。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// 傳回結果:
// 指定路徑上的隻讀 System.IO.FileStream。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
public static FileStream OpenRead(string path);
//
// 摘要:
// 打開現有 UTF-8 編碼文本檔案以進行讀取。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// 傳回結果:
// 指定路徑上的 System.IO.StreamReader。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static StreamReader OpenText(string path);
//
// 摘要:
// 打開一個現有檔案或建立一個新檔案以進行寫入。
//
// 參數:
// path:
// 要打開以進行寫入的檔案。
//
// 傳回結果:
// 指定路徑上具有 System.IO.FileStream 通路權限的非共享的 System.IO.FileAccess.Write 對象。
//
// 異常:
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。 - 或 - path 指定一個隻讀檔案或目錄。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static FileStream OpenWrite(string path);
//
// 摘要:
// 打開一個二進制檔案，将檔案的内容讀入一個位元組數組，然後關閉該檔案。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// 傳回結果:
// 包含檔案内容的位元組數組。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static byte[] ReadAllBytes(string path);
//
// 摘要:
// 打開一個檔案，使用指定的編碼讀取檔案的所有行，然後關閉該檔案。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// encoding:
// 應用到檔案内容的編碼。
//
// 傳回結果:
// 包含檔案所有行的字元串數組。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static string[] ReadAllLines(string path, Encoding encoding);
//
// 摘要:
// 打開一個文本檔案，讀取檔案的所有行，然後關閉該檔案。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// 傳回結果:
// 包含檔案所有行的字元串數組。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static string[] ReadAllLines(string path);
//
// 摘要:
// 打開一個文本檔案，讀取檔案的所有行，然後關閉該檔案。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// 傳回結果:
// 包含檔案所有行的字元串。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static string ReadAllText(string path);
//
// 摘要:
// 打開一個檔案，使用指定的編碼讀取檔案的所有行，然後關閉該檔案。
//
// 參數:
// path:
// 要打開以進行讀取的檔案。
//
// encoding:
// 應用到檔案内容的編碼。
//
// 傳回結果:
// 包含檔案所有行的字元串。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 中指定的檔案。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static string ReadAllText(string path, Encoding encoding);
//
// 摘要:
// 讀取檔案的行。
//
// 參數:
// path:
// 要讀取的檔案。
//
// 傳回結果:
// 該檔案的所有行或查詢結果所示的行。
//
// 異常:
// T:System.ArgumentException:
// path 為長度為零的字元串，僅包含空白，或包含 System.IO.Path.GetInvalidPathChars 方法定義的一個或多個無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，它在未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。 - 或 - 調用方沒有所要求的權限。
public static IEnumerable<string> ReadLines(string path);
//
// 摘要:
// 讀取具有指定編碼的檔案的行。
//
// 參數:
// path:
// 要讀取的檔案。
//
// encoding:
// 應用到檔案内容的編碼。
//
// 傳回結果:
// 該檔案的所有行或查詢結果所示的行。
//
// 異常:
// T:System.ArgumentException:
// path 為長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.GetInvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，它在未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 未找到 path 指定的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。 - 或 - 調用方沒有所要求的權限。
public static IEnumerable<string> ReadLines(string path, Encoding encoding);
//
// 摘要:
// 使用其他檔案的内容替換指定檔案的内容，這一過程将删除原始檔案，并建立被替換檔案的備份。
//
// 參數:
// sourceFileName:
// 替換由 destinationFileName 指定的檔案的檔案名。
//
// destinationFileName:
// 被替換檔案的名稱。
//
// destinationBackupFileName:
// 備份檔案的名稱。
//
// 異常:
// T:System.ArgumentException:
// destinationFileName 參數描述的路徑格式不合法。 - 或 - destinationBackupFileName 參數描述的路徑格式不合法。
//
// T:System.ArgumentNullException:
// destinationFileName 參數為 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了無效的驅動器。
//
// T:System.IO.FileNotFoundException:
// 找不到目前 System.IO.FileInfo 對象描述的檔案。 - 或 - 找不到 destinationBackupFileName 參數描述的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。 - 或 - sourceFileName 和 destinationFileName 參數指定相同的檔案。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.PlatformNotSupportedException:
// 作業系統是 Windows 98 Second Edition 或更早版本，且檔案系統不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// sourceFileName 或 destinationFileName 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - 源參數或目标參數指定的是目錄，而不是檔案。
// - 或 - 調用方沒有所要求的權限。
public static void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName);
//
// 摘要:
// 用其他檔案的内容替換指定檔案的内容，這一過程将删除原始檔案，并建立被替換檔案的備份，還可以忽略合并錯誤。
//
// 參數:
// sourceFileName:
// 替換由 destinationFileName 指定的檔案的檔案名。
//
// destinationFileName:
// 被替換檔案的名稱。
//
// destinationBackupFileName:
// 備份檔案的名稱。
//
// ignoreMetadataErrors:
// 如果忽略從被替換檔案到替換檔案的合并錯誤（如特性和通路控制清單 (ACL)），則為 true，否則為 false。
//
// 異常:
// T:System.ArgumentException:
// destinationFileName 參數描述的路徑格式不合法。 - 或 - destinationBackupFileName 參數描述的路徑格式不合法。
//
// T:System.ArgumentNullException:
// destinationFileName 參數為 null。
//
// T:System.IO.DriveNotFoundException:
// 指定了無效的驅動器。
//
// T:System.IO.FileNotFoundException:
// 找不到目前 System.IO.FileInfo 對象描述的檔案。 - 或 - 找不到 destinationBackupFileName 參數描述的檔案。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。 - 或 - sourceFileName 和 destinationFileName 參數指定相同的檔案。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.PlatformNotSupportedException:
// 作業系統是 Windows 98 Second Edition 或更早版本，且檔案系統不是 NTFS。
//
// T:System.UnauthorizedAccessException:
// sourceFileName 或 destinationFileName 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - 源參數或目标參數指定的是目錄，而不是檔案。
// - 或 - 調用方沒有所要求的權限。
public static void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);
//
// 摘要:
// 将 System.Security.AccessControl.FileSecurity 對象描述的通路控制清單 (ACL) 項應用于指定的檔案。
//
// 參數:
// path:
// 從其中添加或移除通路控制清單 (ACL) 項的檔案。
//
// fileSecurity:
// 一個 System.Security.AccessControl.FileSecurity 對象，描述要應用于 path 參數所描述的檔案的 ACL 項。
//
// 異常:
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.Runtime.InteropServices.SEHException:
// path 參數為 null。
//
// T:System.SystemException:
// 找不到檔案。
//
// T:System.UnauthorizedAccessException:
// path 參數指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 參數指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.ArgumentNullException:
// fileSecurity 參數為 null。
[SecuritySafeCritical]
public static void SetAccessControl(string path, FileSecurity fileSecurity);
//
// 摘要:
// 擷取指定路徑上的檔案的指定 System.IO.FileAttributes。
//
// 參數:
// path:
// 檔案的路徑。
//
// fileAttributes:
// 枚舉值的按位組合。
//
// 異常:
// T:System.ArgumentException:
// path 為空，隻包含空格，包含無效字元或檔案屬性無效。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.FileNotFoundException:
// 無法找到該檔案。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void SetAttributes(string path, FileAttributes fileAttributes);
//
// 摘要:
// 設定建立該檔案的日期和時間。
//
// 參數:
// path:
// 要設定其建立日期和時間資訊的檔案。
//
// creationTime:
// 一個 System.DateTime，它包含要為 path 的建立日期和時間設定的值。 該值用本地時間表示。
//
// 異常:
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.IOException:
// 執行操作時發生 I/O 錯誤。
//
// T:System.ArgumentOutOfRangeException:
// creationTime 指定的值超出了該操作所允許的日期範圍和/或時間範圍。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
public static void SetCreationTime(string path, DateTime creationTime);
//
// 摘要:
// 設定檔案建立的日期和時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要設定其建立日期和時間資訊的檔案。
//
// creationTimeUtc:
// 一個 System.DateTime，它包含要為 path 的建立日期和時間設定的值。 該值用 UTC 時間表示。
//
// 異常:
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.IOException:
// 執行操作時發生 I/O 錯誤。
//
// T:System.ArgumentOutOfRangeException:
// creationTime 指定的值超出了該操作所允許的日期範圍和/或時間範圍。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
[SecuritySafeCritical]
public static void SetCreationTimeUtc(string path, DateTime creationTimeUtc);
//
// 摘要:
// 設定上次通路指定檔案的日期和時間。
//
// 參數:
// path:
// 要設定其通路日期和時間資訊的檔案。
//
// lastAccessTime:
// 一個 System.DateTime，它包含要為 path 的上次通路日期和時間設定的值。 該值用本地時間表示。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.ArgumentOutOfRangeException:
// lastAccessTime 指定的值超出了該操作所允許的日期或時間範圍。
public static void SetLastAccessTime(string path, DateTime lastAccessTime);
//
// 摘要:
// 設定上次通路指定的檔案的日期和時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要設定其通路日期和時間資訊的檔案。
//
// lastAccessTimeUtc:
// 一個 System.DateTime，它包含要為 path 的上次通路日期和時間設定的值。 該值用 UTC 時間表示。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.ArgumentOutOfRangeException:
// lastAccessTimeUtc 指定的值超出了該操作所允許的日期或時間範圍。
[SecuritySafeCritical]
public static void SetLastAccessTimeUtc(string path, DateTime lastAccessTimeUtc);
//
// 摘要:
// 設定上次寫入指定檔案的日期和時間。
//
// 參數:
// path:
// 要設定其日期和時間資訊的檔案。
//
// lastWriteTime:
// 一個 System.DateTime，它包含要為 path 的上次寫入日期和時間設定的值。 該值用本地時間表示。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.ArgumentOutOfRangeException:
// lastWriteTime 指定的值超出了該操作所允許的日期或時間範圍。
public static void SetLastWriteTime(string path, DateTime lastWriteTime);
//
// 摘要:
// 設定上次寫入指定的檔案的日期和時間，其格式為協調通用時 (UTC)。
//
// 參數:
// path:
// 要設定其日期和時間資訊的檔案。
//
// lastWriteTimeUtc:
// 一個 System.DateTime，它包含要為 path 的上次寫入日期和時間設定的值。 該值用 UTC 時間表示。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.FileNotFoundException:
// 未找到指定路徑。
//
// T:System.UnauthorizedAccessException:
// 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.ArgumentOutOfRangeException:
// lastWriteTimeUtc 指定的值超出了該操作所允許的日期或時間範圍。
[SecuritySafeCritical]
public static void SetLastWriteTimeUtc(string path, DateTime lastWriteTimeUtc);
//
// 摘要:
// 建立一個新檔案，在其中寫入指定的位元組數組，然後關閉該檔案。 如果目标檔案已存在，則覆寫該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// bytes:
// 要寫入檔案的位元組。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null 或位元組數組為空。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void WriteAllBytes(string path, byte[] bytes);
//
// 摘要:
// 建立一個新檔案，在其中寫入指定的位元組數組，然後關閉該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入檔案的字元串數組。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 或 contents 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static void WriteAllLines(string path, string[] contents);
//
// 摘要:
// 建立一個新檔案，使用指定編碼在其中寫入指定的字元串數組，然後關閉該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入檔案的字元串數組。
//
// encoding:
// 一個 System.Text.Encoding 對象，它表示應用于字元串數組的字元編碼。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 或 contents 為 null。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
public static void WriteAllLines(string path, string[] contents, Encoding encoding);
//
// 摘要:
// 建立一個新檔案，向其中寫入一個字元串集合，然後關閉該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入到檔案中的行。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.GetInvalidPathChars 方法定義的無效字元。
//
// T:System.ArgumentNullException:
// path 或 contents 是 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。 - 或 - 調用方沒有所要求的權限。
public static void WriteAllLines(string path, IEnumerable<string> contents);
//
// 摘要:
// 使用指定的編碼建立一個新檔案，向其中寫入一個字元串集合，然後關閉該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入到檔案中的行。
//
// encoding:
// 要使用的字元編碼。
//
// 異常:
// T:System.ArgumentException:
// path 為長度為零的字元串，僅包含空白，或包含 System.IO.Path.GetInvalidPathChars 方法定義的一個或多個無效字元。
//
// T:System.ArgumentNullException:
// path contents 或 encoding 為 null。
//
// T:System.IO.DirectoryNotFoundException:
// path 無效（例如，它在未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.IO.PathTooLongException:
// path 超出系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
//
// T:System.UnauthorizedAccessException:
// path 指定隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 是一個目錄。 - 或 - 調用方沒有所要求的權限。
public static void WriteAllLines(string path, IEnumerable<string> contents, Encoding encoding);
//
// 摘要:
// 建立一個新檔案，向其中寫入指定的字元串，然後關閉檔案。 如果目标檔案已存在，則覆寫該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入檔案的字元串。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null 或 contents 為空。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void WriteAllText(string path, string contents);
//
// 摘要:
// 建立一個新檔案，使用指定編碼向其中寫入指定的字元串，然後關閉檔案。 如果目标檔案已存在，則覆寫該檔案。
//
// 參數:
// path:
// 要寫入的檔案。
//
// contents:
// 要寫入檔案的字元串。
//
// encoding:
// 應用于字元串的編碼。
//
// 異常:
// T:System.ArgumentException:
// path 是一個長度為零的字元串，僅包含空格，或包含一個或多個由 System.IO.Path.InvalidPathChars 定義的無效字元。
//
// T:System.ArgumentNullException:
// path 為 null 或 contents 為空。
//
// T:System.IO.PathTooLongException:
// 指定的路徑和/或檔案名超過了系統定義的最大長度。 例如，在基于 Windows 的平台上，路徑必須少于 248 個字元，且檔案名必須少于 260 個字元。
//
// T:System.IO.DirectoryNotFoundException:
// 指定的路徑無效（例如，它位于未映射的驅動器上）。
//
// T:System.IO.IOException:
// 打開檔案時發生 I/O 錯誤。
//
// T:System.UnauthorizedAccessException:
// path 指定了一個隻讀檔案。 - 或 - 目前平台不支援此操作。 - 或 - path 指定了一個目錄。 - 或 - 調用方沒有所要求的權限。
//
// T:System.NotSupportedException:
// path 的格式無效。
//
// T:System.Security.SecurityException:
// 調用方沒有所要求的權限。
[SecuritySafeCritical]
public static void WriteAllText(string path, string contents, Encoding encoding);
}
}
![Unity遊戲開發背景知識[圖]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)