File 類別

定義

[Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)]
public class File : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable

[<Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)>]
type File = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable

繼承

Object

JavaObject

Object

File

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IComparable IDisposable

備註

檔案與目錄路徑名稱的抽象表示。

使用者介面與作業系統使用系統依賴的 <em>路徑名稱字串</em> 來命名檔案與目錄。 此類別呈現一種抽象且系統無關的階層路徑名稱觀點。 <EM>抽象路徑名稱</em> 包含兩個組成部分：

olli 一個可選的系統依賴 em前綴/em 字串，例如磁碟機指定符，&nbsp;UNIX 根目錄，或  對於一個Microsoft Windows UNC 路徑名稱，以及 li 一列零個或多個字串 em名稱/em。 </ol>

抽象路徑名稱中的第一個名稱可能是目錄名稱，或在Microsoft Windows UNC路徑名稱的情況下，則是主機名稱。 抽象路徑名稱中的每個後續名稱代表一個目錄;姓氏可以代表目錄或檔案。 <em>empty</em> 抽象路徑名稱沒有前綴，且名稱序列為空。

路徑名稱字串轉換為或從抽象路徑名稱轉換本質上是系統依賴的。 當抽象路徑名稱轉換成路徑名稱字串時，每個名稱之間會以一份預設 <的 em>分隔符/<em> 分隔。 預設的名稱分隔符由系統屬性 file.separator定義，並可在公開靜態欄位 {@link #separator} 及 {@link #separatorChar} 此類別中提供。 當路徑名稱字串轉換成抽象路徑名稱時，其中的名稱可能以預設的名稱分隔符或底層系統支援的其他名稱分隔符來分隔。

路徑名稱，無論是抽象形式還是字串形式，都可以是 em absolute/em< 或 >em<relative>/em<。><> 絕對路徑名稱是完整的，因為不需要其他資訊即可定位它所指的檔案。 相對地，相對路徑名稱必須以從其他路徑名稱取得的資訊來解釋。 預設情況下， java.io 套件中的類別總是以目前使用者目錄來解析相對路徑名稱。 此目錄由系統屬性user.dir命名，通常是呼叫 Java 虛擬機的目錄。

<抽象路徑名稱的 em>< 父 em> 可透過呼叫#getParent此類別的方法取得，該名稱包含路徑名稱的前綴及路徑名稱序列中除最後一個外的每個名稱。 每個目錄的絕對路徑名稱是任何 File 擁有絕對抽象路徑名稱的物件的祖先，該路徑名稱以該目錄的絕對路徑名稱開頭。 例如，抽象路徑名稱 "/usr" 所表示的目錄，是路徑名稱 "/usr/local/bin"所表示的目錄的祖先。

前綴概念用於處理 UNIX 平台上的根目錄，以及Microsoft Windows平台上的驅動指定符、根目錄與 UNC 路徑名稱，具體如下：

<UL>

<li> 對於 UNIX 平台，絕對路徑名稱的前綴總是 "/"。 相關路徑名稱沒有前綴。 代表根目錄的抽象路徑名稱包含前綴 "/" 和空的名稱序列。

<li> 對於Microsoft Windows平台，包含磁碟機指定符的路徑名稱前綴為磁碟機代號，若":"路徑名稱為絕對，則可能接著。"\\" UNC 路徑名稱的前綴為 "\\\\";主機名稱與共享名稱為名稱序列中的前兩個名稱。 若關聯路徑名稱未指定磁碟機，則不包含前綴。

</ul>

此類別的實例可能代表或不代表實際的檔案系統物件，如檔案或目錄。 如果它確實表示這樣的物件，則該物件位於 一個分割中。 分割區是檔案系統中作業系統特定的儲存區塊。 單一儲存裝置（例如實體磁碟機、快閃記憶體 CD-ROM）可能包含多個分割區。 該物件（若有）將位於由該路徑名稱絕對形式的祖先命名的分割「partName」>上。

檔案系統可能會對實際檔案系統物件（如讀取、寫入和執行）實施某些操作的限制。 這些限制統稱為 存取權限。 檔案系統可能對單一物件擁有多組存取權限。 例如，一組可能適用於物件 的擁有者，另一組則可能適用於所有其他使用者。 物件的存取權限可能導致此類別中的某些方法失敗。

類別的 File 實例是不變的;也就是說，一旦建立，物件 File 所代表的抽象路徑名稱將永遠不變。

<h3>與 java.nio.file 套件</h3 的互通性>

<cjava.nio.file></c> 套件定義了 Java 虛擬機存取檔案、檔案屬性及檔案系統的介面與類別。 此 API 可用來克服類別的 java.io.File 許多限制。 此#toPath toPath方法可用於取得利用物件Path所代表的抽象路徑定位檔案的 。File 所得結果 Path 可與類別結合 java.nio.file.Files 使用，提供更有效率且廣泛的額外檔案操作、檔案屬性及 I/O 例外存取，以協助在檔案操作失敗時診斷錯誤。

在 Android 上，將字串傳送檔案名稱給作業系統時會轉換成 UTF-8 位元組序列，而作業系統從各種 list 方法回傳的位元組序列則透過解碼成 UTF-8 位元組序列轉成字串。

新增於JDK1.0。

Java 文件 java.io.File。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。