語言

RandomAccessFile 類別

定義

此類別的實例同時支援對隨機存取檔案的讀寫。

[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
繼承
RandomAccessFile
屬性
實作

備註

此類別的實例同時支援對隨機存取檔案的讀寫。 隨機存取檔案的行為就像儲存在檔案系統中的大量位元組陣列。 有一種游標或指向隱含陣列的索引,稱為 檔案指標;輸入操作從檔案指標開始讀取位元組,並將檔案指標推進至已讀取位元組後。 若隨機存取檔案是在讀寫模式下建立,則輸出操作也可用;輸出操作從檔案指標開始寫入位元組,並將檔案指標推進至已寫入的位元組。 若輸出操作寫入超過隱含陣列目前端,則會導致陣列被擴充。 檔案指標可以被 getFilePointer 方法讀取並設定 seek 。

通常,這個類別中所有讀取例程都成立,如果在讀取所需位元組數前就已到達檔案結束點,會拋出一個EOFException(這是一種 )。IOException 如果任何位元組因非檔案結束時無法讀取,則拋出一個IOException非 。EOFException 特別是,如果溪流已經關閉,可能會 IOException 被擲出。

新增於JDK1.0。

Java 文件 java.io.RandomAccessFile。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱 Description
RandomAccessFile(File, String)

建立一個隨機存取檔案串流,用於讀取並可選擇寫入參數指定的 File 檔案。

RandomAccessFile(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

RandomAccessFile(String, String)

建立一個隨機存取檔案串流,用於讀取並可選擇寫入指定名稱的檔案。

屬性

名稱 Description
Channel

回傳與此檔案相關聯的唯一 java.nio.channels.FileChannel FileChannel 物件。

Class

回傳此 Object的執行時類別。

(繼承來源 Object)
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)

從此檔案讀取最多位 len 元組的資料到位元組陣列中。

Read(Byte[])

從此檔案讀取最多位 b.length 元組的資料到位元組陣列中。

ReadAsync()

從任務中的檔案讀取一個位元組。

ReadAsync(Byte[], Int32, Int32)

將檔案位元組讀取到任務中的緩衝區範圍。

ReadAsync(Byte[])

將檔案位元組讀取到任務中的緩衝區。

ReadBoolean()

從這個檔案讀取 a boolean 。

ReadBooleanAsync()

從任務中的檔案讀取布林值。

ReadByte()

從此檔案讀取一個有符號的八位元值。

ReadByteAsync()

從任務中的檔案讀取一個已簽署的位元組。

ReadChar()

讀取這個檔案中的一個字元。

ReadCharAsync()

從任務中的檔案讀取 16 位元字元。

ReadDouble()

從這個檔案讀取 a double 。

ReadDoubleAsync()

從任務中的檔案讀取雙精度值。

ReadFloat()

從這個檔案讀取 a float 。

ReadFloatAsync()

從任務中的檔案讀取單精度值。

ReadFully(Byte[], Int32, Int32)

從目前的檔案指標開始,精確 len 地從這個檔案讀取位元組陣列的位元組。

ReadFully(Byte[])

從此檔案讀取 b.length 位元組到位元組陣列,從當前的檔案指標開始。

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)

嘗試跳過 n 輸入位元組,捨棄跳過的位元組。

SkipBytesAsync(Int32)

在任務中的檔案執行位元組跳過操作。

ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Write(Byte[], Int32, Int32)

從 len 指定的位元組陣列從偏移 off 量開始寫入該檔案的位元組。

Write(Byte[])

從 b.length 指定的位元組陣列寫入位元組到此檔案,從目前的檔案指標開始。

Write(Int32)

將指定的位元組寫入此檔案。

WriteAsync(Byte[], Int32, Int32)

將位元組陣列範圍寫入任務中的檔案。

WriteAsync(Byte[])

將位元組陣列寫入任務中的檔案。

WriteAsync(Int32)

在任務中寫入一個位元組到檔案。

WriteBoolean(Boolean)

將 a boolean 寫入檔案,作為一個位元組的值。

WriteBooleanAsync(Boolean)

將布林值以一個位元組的形式寫入檔案,在任務中。

WriteByte(Int32)

將 a byte 寫入檔案,作為一個位元組的值。

WriteByteAsync(Int32)

將 8 位元值寫入任務中的檔案。

WriteBytes(String)

將字串以位元組序列的形式寫入檔案。

WriteBytesAsync(String)

在任務中,每個字串字元寫入一個檔案位元組。

WriteChar(Int32)

將 a char 寫入檔案為兩位元組值,先寫高位元組。

WriteCharAsync(Int32)

在任務中將一個 16 位元寫入檔案,且高位元組排在前面。

WriteChars(String)

會將字串寫入檔案,作為一串字元。

WriteCharsAsync(String)

在任務中,每個字串字元寫入兩個檔案位元組。

WriteDouble(Double)

利用long類別doubleToLongBits中的方法將 double 參數轉換為 aDouble,然後將該long值寫入檔案中,先寫入高位元組的八位元組數量。

WriteDoubleAsync(Double)

將雙精度值寫入任務中的檔案。

WriteFloat(Single)

利用int類別floatToIntBits中的方法將浮點參數轉換成 ,Float然後將該int值以四位元組的數量寫入檔案,先寫入高位元組。

WriteFloatAsync(Single)

將單精度值寫入任務中的檔案。

WriteInt(Int32)

將 an int 寫入檔案為四個位元組,先寫高位元組。

WriteIntAsync(Int32)

在任務中,將一個 32 位元組寫入檔案,且位元組位元排在前面。

WriteLong(Int64)

將 a long 寫入檔案為八位元組,先寫高位元組。

WriteLongAsync(Int64)

在任務中,將高位元組寫入檔案,寫入 64 位元整數。

WriteShort(Int32)

將 a short 寫入檔案為兩個位元組,先寫高位元組。

WriteShortAsync(Int32)

在任務中將 16 位元元組寫入以高位元組為先的檔案。

WriteUTF(String)

以修改過的 UTF-8 編碼,以機器獨立的方式寫入字串。

WriteUTFAsync(String)

將長度前綴修改的 UTF-8 文字寫入任務中的檔案。

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

ReadBooleanAsync(IDataInput)

讀取任務中的布林值。

ReadByteAsync(IDataInput)

讀取任務中的一個已簽署的位元組。

ReadCharAsync(IDataInput)

讀取任務中的 16 位元字元。

ReadDoubleAsync(IDataInput)

讀取任務中的雙精度值。

ReadFloatAsync(IDataInput)

讀取任務中的單一精度值值。

ReadFullyAsync(IDataInput, Byte[], Int32, Int32)

在任務中,從輸入處填滿緩衝區範圍。

ReadFullyAsync(IDataInput, Byte[])

從任務中的輸入填滿位元組陣列。

ReadIntAsync(IDataInput)

讀取任務中的帶號 32 位元整數。

ReadLineAsync(IDataInput)

讀取任務中的位元組文字行。

ReadLongAsync(IDataInput)

讀取任務中的帶符號 64 位元整數。

ReadShortAsync(IDataInput)

讀取任務中的帶號 16 位元整數。

ReadUnsignedByteAsync(IDataInput)

讀取任務中的未簽名位元組。

ReadUnsignedShortAsync(IDataInput)

讀取任務中的無符號 16 位元整數。

ReadUTFAsync(IDataInput)

讀取任務中長度前綴修改的 UTF-8 文字。

SkipBytesAsync(IDataInput, Int32)

跳過任務中的輸入位元組。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

WriteAsync(IDataOutput, Byte[], Int32, Int32)

將位元組陣列範圍寫入任務中的輸出。

WriteAsync(IDataOutput, Byte[])

將位元組陣列寫入任務中的輸出。

WriteAsync(IDataOutput, Int32)

在任務中將一個位元組寫入輸出。

WriteBooleanAsync(IDataOutput, Boolean)

在任務中以一個位元組寫入布林值。

WriteByteAsync(IDataOutput, Int32)

在任務中寫入 8 位元值。

WriteBytesAsync(IDataOutput, String)

在任務中,每個字串字元寫入一個位元組。

WriteCharAsync(IDataOutput, Int32)

在任務中以高位元組為首位元組寫入 16 位元字元。

WriteCharsAsync(IDataOutput, String)

在任務中,每個字串字元寫入兩個位元組。

WriteDoubleAsync(IDataOutput, Double)

在任務中寫入雙精度值。

WriteFloatAsync(IDataOutput, Single)

在任務中寫入單精度值。

WriteIntAsync(IDataOutput, Int32)

在任務中以高位元組為先寫入 32 位元整數。

WriteLongAsync(IDataOutput, Int64)

在任務中以高位元組為先寫入 64 位元整數。

WriteShortAsync(IDataOutput, Int32)

在任務中以高位元組為先寫入 16 位元整數。

WriteUTFAsync(IDataOutput, String)

在任務中寫入以長度為前綴的修改過的 UTF-8 文字。

適用於