File 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供建立、複製、刪除、移動和開啟單一檔案的靜態方法，並協助 FileStream 物件的建立。
public ref class File abstract sealedpublic ref class File sealedpublic static class Filepublic sealed class File[System.Runtime.InteropServices.ComVisible(true)]
public static class Filetype File = class[<System.Runtime.InteropServices.ComVisible(true)>]
type File = classPublic Class FilePublic NotInheritable Class File- 繼承
-
File
- 屬性
範例
下列範例示範如何使用 File 類別來檢查檔案是否存在，以及根據結果，建立新檔案並寫入檔案，或開啟現有的檔案並從中讀取。 在執行程式碼之前，請先建立 c:\temp 資料夾。
using namespace System;
using namespace System::IO;
int main()
{
String^ path = "c:\\temp\\MyTest.txt";
if ( !File::Exists( path ) )
{
// Create a file to write to.
StreamWriter^ sw = File::CreateText( path );
try
{
sw->WriteLine( "Hello" );
sw->WriteLine( "And" );
sw->WriteLine( "Welcome" );
}
finally
{
if ( sw )
delete (IDisposable^)(sw);
}
}
// Open the file to read from.
StreamReader^ sr = File::OpenText( path );
try
{
String^ s = "";
while ( s = sr->ReadLine() )
{
Console::WriteLine( s );
}
}
finally
{
if ( sr )
delete (IDisposable^)(sr);
}
try
{
String^ path2 = String::Concat( path, "temp" );
// Ensure that the target does not exist.
File::Delete( path2 );
// Copy the file.
File::Copy( path, path2 );
Console::WriteLine( "{0} was copied to {1}.", path, path2 );
// Delete the newly created file.
File::Delete( path2 );
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 = @"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);
}
}
}
}
open System.IO
let path = @"c:\temp\MyTest.txt"
if File.Exists path |> not then
// Create a file to write to.
use sw = File.CreateText path
sw.WriteLine "Hello"
sw.WriteLine "And"
sw.WriteLine "Welcome"
// Open the file to read from.
do
use sr = File.OpenText path
let mutable s = sr.ReadLine()
while isNull s |> not do
printfn $"{s}"
s <- sr.ReadLine()
Imports System.IO
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
If File.Exists(path) = False Then
' Create a file to write to.
Using sw As StreamWriter = File.CreateText(path)
sw.WriteLine("Hello")
sw.WriteLine("And")
sw.WriteLine("Welcome")
End Using
End If
' Open the file to read from.
Using sr As StreamReader = File.OpenText(path)
Do While sr.Peek() >= 0
Console.WriteLine(sr.ReadLine())
Loop
End Using
End Sub
End Class
備註
針對 File 一般作業使用 類別，例如複製、移動、重新命名、建立、開啟、刪除，以及一次附加至單一檔案。 您也可以使用 File 類別來取得和設定與建立、存取和寫入檔案相關的檔案屬性或 DateTime 資訊。 如果您想要對多個檔案執行作業，請參閱 Directory.GetFiles 或 DirectoryInfo.GetFiles 。
當您建立或開啟檔案時， File 許多方法都會傳回其他 I/O 類型。 您可以使用這些其他類型的來進一步操作檔案。 如需詳細資訊，請參閱特定 File 成員，例如 OpenText 、 CreateText 或 Create 。
由於所有 File 方法都是靜態的，因此如果您想要只執行一個 File 動作，則使用方法而不是對應的 FileInfo 實例方法可能會更有效率。 所有 File 方法都需要您正在操作之檔案的路徑。
類別的 File 靜態方法會對所有方法執行安全性檢查。 如果您要重複使用物件數次，請考慮改用 對應的實例方法 FileInfo ，因為安全性檢查不一定是必要的。
根據預設，會將新檔案的完整讀取/寫入權限授與所有使用者。
下表描述用來自訂各種 File 方法行為的列舉。
| 列舉型別 | 描述 |
|---|---|
| FileAccess | 指定檔案的讀取和寫入權限。 |
| FileShare | 指定已使用中之檔案允許的存取層級。 |
| FileMode | 指定是否保留或覆寫現有檔案的內容，以及建立現有檔案的要求是否造成例外狀況。 |
注意
在接受路徑做為輸入字串的成員中，該路徑的格式必須正確或引發例外狀況。 例如，如果路徑為完整，但開頭為空格，則路徑不會在 類別的方法中修剪。 因此，路徑格式不正確，並引發例外狀況。 同樣地，路徑或路徑組合不能完整兩次。 例如，在大部分情況下，「c：\temp c：\windows」 也會引發例外狀況。 使用接受路徑字串的方法時，請確定您的路徑格式正確。
在接受路徑的成員中，路徑可以參考檔案或只參考目錄。 指定的路徑也可以參考伺服器和共用名稱稱的相對路徑或通用命名慣例 (UNC) 路徑。 例如，下列所有都是可接受的路徑：
"c:\\\MyDir\\\MyFile.txt"在 C# 或"c:\MyDir\MyFile.txt"Visual Basic 中。"c:\\\MyDir"在 C# 或"c:\MyDir"Visual Basic 中。"MyDir\\\MySubdir"在 C# 或"MyDir\MySubDir"Visual Basic 中。"\\\\\\\MyServer\\\MyShare"在 C# 或"\\\MyServer\MyShare"Visual Basic 中。
如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。
方法
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應