FileInfo 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供建立、複製、刪除、移動及開啟檔案的屬性與實例方法，並協助物件建立 FileStream 。 此類別無法獲得繼承。
public ref class FileInfo sealed : System::IO::FileSystemInfopublic sealed class FileInfo : System.IO.FileSystemInfo[System.Serializable]
public sealed class FileInfo : System.IO.FileSystemInfo[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class FileInfo : System.IO.FileSystemInfotype FileInfo = class
inherit FileSystemInfo[<System.Serializable>]
type FileInfo = class
inherit FileSystemInfo[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileInfo = class
inherit FileSystemInfoPublic NotInheritable Class FileInfo
Inherits FileSystemInfo- 繼承
- 繼承
- 屬性
範例
以下範例展示了該 FileInfo 類別中的一些主要成員。
當屬性首次取得時，呼叫 FileInfo 該 Refresh 方法並快取關於檔案的資訊。 在後續通話中，您必須致電 Refresh 取得最新資訊副本。
using System;
using System.IO;
class Test
{
public static void Main()
{
string path = Path.GetTempFileName();
var fi1 = new FileInfo(path);
// Create a file to write to.
using (StreamWriter sw = fi1.CreateText())
{
sw.WriteLine("Hello");
sw.WriteLine("And");
sw.WriteLine("Welcome");
}
// Open the file to read from.
using (StreamReader sr = fi1.OpenText())
{
var s = "";
while ((s = sr.ReadLine()) != null)
{
Console.WriteLine(s);
}
}
try
{
string path2 = Path.GetTempFileName();
var fi2 = new FileInfo(path2);
// Ensure that the target does not exist.
fi2.Delete();
// Copy the file.
fi1.CopyTo(path2);
Console.WriteLine($"{path} was copied to {path2}.");
// Delete the newly created file.
fi2.Delete();
Console.WriteLine($"{path2} was successfully deleted.");
}
catch (Exception e)
{
Console.WriteLine($"The process failed: {e.ToString()}");
}
}
}
Imports System.IO
Public Class Test
Public Shared Sub Main()
Dim path1 As String = Path.GetTempFileName()
Dim path2 As String = Path.GetTempFileName()
Dim fi As New FileInfo(path1)
' Create a file to write to.
Using sw As StreamWriter = fi.CreateText()
sw.WriteLine("Hello")
sw.WriteLine("And")
sw.WriteLine("Welcome")
End Using
Try
' Open the file to read from.
Using sr As StreamReader = fi.OpenText()
Do While sr.Peek() >= 0
Console.WriteLine(sr.ReadLine())
Loop
End Using
Dim fi2 As New FileInfo(path2)
' Ensure that the target does not exist.
fi2.Delete()
' Copy the file.
fi.CopyTo(path2)
Console.WriteLine($"{path1} was copied to {path2}.")
' Delete the newly created file.
fi2.Delete()
Console.WriteLine($"{path2} was successfully deleted.")
Catch e As Exception
Console.WriteLine($"The process failed: {e.ToString()}.")
End Try
End Sub
End Class
此範例會產生類似下列的輸出。
Hello
And
Welcome
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.
備註
使用這個 FileInfo 類別來執行典型操作，例如複製、移動、重新命名、建立、開啟、刪除及附加檔案。
如果你對同一檔案執行多個操作，使用 FileInfo 實例方法而非類別對應的靜態方法 File 更有效率，因為安全性檢查不一定是必要的。
許多方法在建立或開啟檔案時會 FileInfo 回傳其他 I/O 類型。 您可以使用這些其他類型的來進一步操作檔案。 欲了解更多資訊，請參閱具體FileInfo成員如 Open、 OpenRead、 OpenTextCreateTextCreate、 或 。
根據預設，對新檔案的完整讀取/寫入存取權會授與所有使用者。
下表描述用於客製化各種 FileInfo 方法行為的列舉。
| Enumeration | 描述 |
|---|---|
| FileAccess | 指定檔案的讀取和寫入存取權。 |
| FileShare | 指定已使用之檔案允許的存取層級。 |
| FileMode | 指定是否保留或覆寫現有檔案的內容，以及建立現有檔案的要求是否造成例外狀況。 |
Note
在接受路徑做為輸入字串的成員中，該路徑的格式必須良好或引發例外狀況。 例如，如果路徑為完整，但開頭為空格，則路徑不會在 類別的方法中修剪。 因此，路徑的格式不正確，而且會引發例外狀況。 同樣地，路徑或路徑的組合不能完全限定兩次。 例如，在大部分情況下，“c：\temp c：\windows” 也會引發例外狀況。 使用接受路徑字串的方法時，請確定您的路徑格式良好。
在接受路徑的成員中，路徑可以參考檔案或只參考目錄。 指定的路徑也可以參考伺服器和共享名稱的相對路徑或通用命名慣例 （UNC） 路徑。 例如，下列所有都是可接受的路徑：
C# 中的「c：\\MyDir\\MyFile.txt」，或 Visual Basic 中的「c：\MyDir\MyFile.txt」。
C# 中的 “c：\\MyDir” 或 Visual Basic 中的 “c：\MyDir”。
C# 中的 “MyDir\\MySubdir” 或 Visual Basic 中的 “MyDir\MySubDir”。
C# 中的 “\\\\MyServer\\MyShare” 或 Visual Basic 中的 “\\MyServer\MyShare”。
這個 FileInfo 類別提供了以下屬性，讓你能夠取得關於檔案的資訊。 如需如何使用每個屬性的範例，請參閱屬性頁。
這個 Directory 屬性會取得一個物件，代表檔案的父目錄。
此 DirectoryName 屬性可取得檔案父目錄的完整路徑。
該 Exists 屬性會在操作前檢查檔案的存在。
這個 IsReadOnly 屬性會擷取或設定一個值，指定檔案是否可以被修改。
它 Length 會取得檔案大小。
它 Name 會取得檔案名稱。
建構函式
| 名稱 | Description |
|---|---|
| FileInfo(String) |
初始化一個新的類別實例 FileInfo ，作為檔案路徑的包裝器。 |
欄位
| 名稱 | Description |
|---|---|
| FullPath |
表示目錄或檔案的完整路徑。 (繼承來源 FileSystemInfo) |
| OriginalPath |
使用者原本指定的路徑，無論是相對路徑還是絕對路徑。 (繼承來源 FileSystemInfo) |
屬性
| 名稱 | Description |
|---|---|
| Attributes |
取得或設定目前檔案或目錄的屬性。 (繼承來源 FileSystemInfo) |
| CreationTime |
取得或設定目前檔案或目錄的建立時間。 (繼承來源 FileSystemInfo) |
| CreationTimeUtc |
取得或設定目前檔案或目錄的建立時間，以協調的通用時間（UTC）為基準。 (繼承來源 FileSystemInfo) |
| Directory |
會取得父目錄的實例。 |
| DirectoryName |
會取得一個字串，代表該目錄的完整路徑。 |
| Exists |
取得值，指出檔案是否存在。 |
| Extension |
取得檔名的副檔名部分，包括開頭的點 |
| FullName |
取得目錄或檔案的完整路徑。 (繼承來源 FileSystemInfo) |
| IsReadOnly |
取得或設定一個值，用以判斷目前檔案是否為唯讀。 |
| LastAccessTime |
取得或設定目前檔案或目錄最後被存取的時間。 (繼承來源 FileSystemInfo) |
| LastAccessTimeUtc |
取得或設定協調世界時間（UTC）中，目前檔案或目錄最後被存取的時間。 (繼承來源 FileSystemInfo) |
| LastWriteTime |
取得或設定目前檔案或目錄最後一次寫入的時間。 (繼承來源 FileSystemInfo) |
| LastWriteTimeUtc |
取得或設定協調世界時間（UTC）中當前檔案或目錄最後一次寫入的時間。 (繼承來源 FileSystemInfo) |
| Length |
取得目前檔案的大小，以位元組為單位。 |
| Name |
取得檔案的名稱。 |