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 namespace System;
using namespace System::IO;
int main()
{
String^ path = Path::GetTempFileName();
FileInfo^ fi1 = gcnew FileInfo( path );
//Create a file to write to.
StreamWriter^ sw = fi1->CreateText();
try
{
sw->WriteLine( "Hello" );
sw->WriteLine( "And" );
sw->WriteLine( "Welcome" );
}
finally
{
if ( sw )
delete (IDisposable^)sw;
}
//Open the file to read from.
StreamReader^ sr = fi1->OpenText();
try
{
String^ s = "";
while ( s = sr->ReadLine() )
{
Console::WriteLine( s );
}
}
finally
{
if ( sr )
delete (IDisposable^)sr;
}
try
{
String^ path2 = Path::GetTempFileName();
FileInfo^ fi2 = gcnew FileInfo( path2 );
//Ensure that the target does not exist.
fi2->Delete();
//Copy the file.
fi1->CopyTo( path2 );
Console::WriteLine( "{0} was copied to {1}.", path, path2 );
//Delete the newly created file.
fi2->Delete();
Console::WriteLine( "{0} was successfully deleted.", path2 );
}
catch ( Exception^ e )
{
Console::WriteLine( "The process failed: {0}", e );
}
}
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、OpenText、CreateText或 Create。
根據預設，對新檔案的完整讀取/寫入存取權會授與所有使用者。
下表描述用來自定義各種 FileInfo 方法行為的列舉。
| 列舉 | 描述 |
|---|---|
| FileAccess | 指定檔案的讀取和寫入存取權。 |
| FileShare | 指定已使用之檔案允許的存取層級。 |
| FileMode | 指定是否保留或覆寫現有檔案的內容，以及建立現有檔案的要求是否造成例外狀況。 |
注意
在接受路徑做為輸入字串的成員中，該路徑的格式必須良好或引發例外狀況。 例如，如果路徑為完整，但開頭為空格，則路徑不會在 類別的方法中修剪。 因此，路徑的格式不正確，而且會引發例外狀況。 同樣地，路徑或路徑的組合不能完全限定兩次。 例如，在大部分情況下，“c：\temp c：\windows” 也會引發例外狀況。 使用接受路徑字串的方法時，請確定您的路徑格式良好。
在接受路徑的成員中，路徑可以參考檔案或只參考目錄。 指定的路徑也可以參考伺服器和共享名稱的相對路徑或通用命名慣例 （UNC） 路徑。 例如，下列所有都是可接受的路徑：
“c：\\MyDir\\MyFile.txt”in C#， or “c：\MyDir\MyFile.txt” in Visual Basic.
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 會擷取檔名。
建構函式
| FileInfo(String) |
初始化 FileInfo 類別的新實例，這個實例可作為檔案路徑的包裝函式。 |
欄位
| FullPath |
表示目錄或檔案的完整路徑。 (繼承來源 FileSystemInfo) |
| OriginalPath |
使用者原本指定的路徑，無論是相對路徑還是絕對路徑。 (繼承來源 FileSystemInfo) |
屬性
| 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 |
取得目前檔案的大小，以位元組為單位。 |
| LinkTarget |
取得位於 FullName的鏈接目標路徑，如果這個 FileSystemInfo 實例不代表連結，則為 |
| Name |
取得檔案的名稱。 |
| UnixFileMode |
取得或設定目前檔案或目錄的 Unix 檔案模式。 (繼承來源 FileSystemInfo) |
方法
擴充方法
| Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) |
建立新的檔案數據流，確保使用指定的屬性和安全性設定來建立它。 |
| GetAccessControl(FileInfo) |
傳回檔案的安全性資訊。 |
| GetAccessControl(FileInfo, AccessControlSections) |
傳回檔案的安全性資訊。 |
| SetAccessControl(FileInfo, FileSecurity) |
變更現有檔案的安全性屬性。 |
