RandomAccessFile 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
此類別的實例同時支援對隨機存取檔案的讀寫。
[Android.Runtime.Register("java/io/RandomAccessFile", DoNotGenerateAcw=true)]
public class RandomAccessFile : Java.Lang.Object, IDisposable, Java.IO.ICloseable, Java.IO.IDataInput, Java.IO.IDataOutput
[<Android.Runtime.Register("java/io/RandomAccessFile", DoNotGenerateAcw=true)>]
type RandomAccessFile = class
inherit Object
interface ICloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IDataInput
interface IDataOutput
- 繼承
- 屬性
- 實作
備註
此類別的實例同時支援對隨機存取檔案的讀寫。 隨機存取檔案的行為就像儲存在檔案系統中的大量位元組陣列。 有一種游標或指向隱含陣列的索引,稱為 檔案指標;輸入操作從檔案指標開始讀取位元組,並將檔案指標推進至已讀取位元組後。 若隨機存取檔案是在讀寫模式下建立,則輸出操作也可用;輸出操作從檔案指標開始寫入位元組,並將檔案指標推進至已寫入的位元組。 若輸出操作寫入超過隱含陣列目前端,則會導致陣列被擴充。 檔案指標可以被 getFilePointer 方法讀取並設定 seek 。
通常,這個類別中所有讀取例程都成立,如果在讀取所需位元組數前就已到達檔案結束點,會拋出一個EOFException(這是一種 )。IOException 如果任何位元組因非檔案結束時無法讀取,則拋出一個IOException非 。EOFException 特別是,如果溪流已經關閉,可能會 IOException 被擲出。
新增於JDK1.0。
Java 文件 java.io.RandomAccessFile。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| RandomAccessFile(File, String) |
建立一個隨機存取檔案串流,用於讀取並可選擇寫入參數指定的 |
| RandomAccessFile(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| RandomAccessFile(String, String) |
建立一個隨機存取檔案串流,用於讀取並可選擇寫入指定名稱的檔案。 |
屬性
| 名稱 | Description |
|---|---|
| Channel |
回傳與此檔案相關聯的唯一 |
| Class |
回傳此 |
| FD |
回傳與此串流相關的不透明檔案描述符物件。 |
| FilePointer |
回傳此檔案中目前的偏移量。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Close() |
關閉此隨機存取檔案串流,並釋放與該串流相關的系統資源。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Length() |
回傳此檔案的長度。 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Read() |
從這個檔案讀取一個位元組的資料。 |
| Read(Byte[], Int32, Int32) |
從此檔案讀取最多位 |
| Read(Byte[]) |
從此檔案讀取最多位 |
| ReadAsync() |
從任務中的檔案讀取一個位元組。 |
| ReadAsync(Byte[], Int32, Int32) |
將檔案位元組讀取到任務中的緩衝區範圍。 |
| ReadAsync(Byte[]) |
將檔案位元組讀取到任務中的緩衝區。 |
| ReadBoolean() |
從這個檔案讀取 a |
| ReadBooleanAsync() |
從任務中的檔案讀取布林值。 |
| ReadByte() |
從此檔案讀取一個有符號的八位元值。 |
| ReadByteAsync() |
從任務中的檔案讀取一個已簽署的位元組。 |
| ReadChar() |
讀取這個檔案中的一個字元。 |
| ReadCharAsync() |
從任務中的檔案讀取 16 位元字元。 |
| ReadDouble() |
從這個檔案讀取 a |
| ReadDoubleAsync() |
從任務中的檔案讀取雙精度值。 |
| ReadFloat() |
從這個檔案讀取 a |
| ReadFloatAsync() |
從任務中的檔案讀取單精度值。 |
| ReadFully(Byte[], Int32, Int32) |
從目前的檔案指標開始,精確 |
| ReadFully(Byte[]) |
從此檔案讀取 |
| ReadFullyAsync(Byte[], Int32, Int32) |
在任務中從檔案中填滿緩衝區範圍。 |
| ReadFullyAsync(Byte[]) |
從任務中的檔案填滿位元組陣列。 |
| ReadInt() |
從此檔案讀取一個有符號的 32 位元整數。 |
| ReadIntAsync() |
從任務中的檔案讀取一個有符號的 32 位元整數。 |
| ReadLine() |
讀出這個檔案的下一行文字。 |
| ReadLineAsync() |
從任務中的檔案讀取以位元組為基礎的文字行。 |
| ReadLong() |
從此檔案讀取一個有符號的 64 位元整數。 |
| ReadLongAsync() |
從任務中的檔案讀取一個有符號的 64 位元整數。 |
| ReadShort() |
從此檔案讀取一個有符號的 16 位元數字。 |
| ReadShortAsync() |
從任務中的檔案讀取一個有號的 16 位元整數。 |
| ReadUnsignedByte() |
從此檔案讀取一個未簽名的八位元數字。 |
| ReadUnsignedByteAsync() |
從任務中的檔案讀取未簽名的位元組。 |
| ReadUnsignedShort() |
從此檔案讀取一個未簽名的 16 位元數字。 |
| ReadUnsignedShortAsync() |
從任務中的檔案讀取一個未帶符號的 16 位元整數。 |
| ReadUTF() |
從這個檔案讀取一個字串。 |
| ReadUTFAsync() |
從任務中的檔案讀取長度前綴修改過的 UTF-8 文字。 |
| Seek(Int64) |
設定檔案指標偏移量,從該檔案開始開始時測量,下一次讀取或寫入發生於此位置。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetLength(Int64) |
設定這個檔案的長度。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| SkipBytes(Int32) |
嘗試跳過 |
| SkipBytesAsync(Int32) |
在任務中的檔案執行位元組跳過操作。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。 (繼承來源 Object) |
| Wait(Int64, Int32) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Wait(Int64) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Write(Byte[], Int32, Int32) |
從 |
| Write(Byte[]) |
從 |
| Write(Int32) |
將指定的位元組寫入此檔案。 |
| WriteAsync(Byte[], Int32, Int32) |
將位元組陣列範圍寫入任務中的檔案。 |
| WriteAsync(Byte[]) |
將位元組陣列寫入任務中的檔案。 |
| WriteAsync(Int32) |
在任務中寫入一個位元組到檔案。 |
| WriteBoolean(Boolean) |
將 a |
| WriteBooleanAsync(Boolean) |
將布林值以一個位元組的形式寫入檔案,在任務中。 |
| WriteByte(Int32) |
將 a |
| WriteByteAsync(Int32) |
將 8 位元值寫入任務中的檔案。 |
| WriteBytes(String) |
將字串以位元組序列的形式寫入檔案。 |
| WriteBytesAsync(String) |
在任務中,每個字串字元寫入一個檔案位元組。 |
| WriteChar(Int32) |
將 a |
| WriteCharAsync(Int32) |
在任務中將一個 16 位元寫入檔案,且高位元組排在前面。 |
| WriteChars(String) |
會將字串寫入檔案,作為一串字元。 |
| WriteCharsAsync(String) |
在任務中,每個字串字元寫入兩個檔案位元組。 |
| WriteDouble(Double) |
利用 |
| WriteDoubleAsync(Double) |
將雙精度值寫入任務中的檔案。 |
| WriteFloat(Single) |
利用 |
| WriteFloatAsync(Single) |
將單精度值寫入任務中的檔案。 |
| WriteInt(Int32) |
將 an |
| WriteIntAsync(Int32) |
在任務中,將一個 32 位元組寫入檔案,且位元組位元排在前面。 |
| WriteLong(Int64) |
將 a |
| WriteLongAsync(Int64) |
在任務中,將高位元組寫入檔案,寫入 64 位元整數。 |
| WriteShort(Int32) |
將 a |
| WriteShortAsync(Int32) |
在任務中將 16 位元元組寫入以高位元組為先的檔案。 |
| WriteUTF(String) |
以修改過的 UTF-8 編碼,以機器獨立的方式寫入字串。 |
| WriteUTFAsync(String) |
將長度前綴修改的 UTF-8 文字寫入任務中的檔案。 |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |