RandomAccessFile 類別

定義

命名空間:: Java.IO

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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

繼承: Object

JavaObject

Object
RandomAccessFile

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ICloseable IDataInput IDataOutput IDisposable

備註

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

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

新增於JDK1.0。

的 java.io.RandomAccessFileJava 檔。

此頁面的部分是根據 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	此類別的實例同時支援對隨機存取檔案的讀寫。
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)	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 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()	此類別的實例同時支援對隨機存取檔案的讀寫。
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()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadLine()	讀出這個檔案的下一行文字。
ReadLineAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadLong()	從此檔案讀取一個有符號的 64 位元整數。
ReadLongAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadShort()	從此檔案讀取一個有符號的 16 位元數字。
ReadShortAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUnsignedByte()	從此檔案讀取一個未簽名的八位元數字。
ReadUnsignedByteAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUnsignedShort()	從此檔案讀取一個未簽名的 16 位元數字。
ReadUnsignedShortAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUTF()	從這個檔案讀取一個字串。
ReadUTFAsync()	此類別的實例同時支援對隨機存取檔案的讀寫。
Seek(Int64)	設定檔案指標偏移量，從該檔案開始開始時測量，下一次讀取或寫入發生於此位置。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetLength(Int64)	設定這個檔案的長度。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
SkipBytes(Int32)	嘗試跳過 `n` 輸入位元組，捨棄跳過的位元組。
SkipBytesAsync(Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 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)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteBytes(String)	將字串以位元組序列的形式寫入檔案。
WriteBytesAsync(String)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteChar(Int32)	將 a `char` 寫入檔案為兩位元組值，先寫高位元組。
WriteCharAsync(Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteChars(String)	會將字串寫入檔案，作為一串字元。
WriteCharsAsync(String)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteDouble(Double)	利用`long`類別`doubleToLongBits`中的方法將 double 參數轉換為 a`Double`，然後將該`long`值寫入檔案中，先寫入高位元組的八位元組數量。
WriteDoubleAsync(Double)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteFloat(Single)	利用`int`類別`floatToIntBits`中的方法將浮點參數轉換成，`Float`然後將該`int`值以四位元組的數量寫入檔案，先寫入高位元組。
WriteFloatAsync(Single)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteInt(Int32)	將 an `int` 寫入檔案為四個位元組，先寫高位元組。
WriteIntAsync(Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteLong(Int64)	將 a `long` 寫入檔案為八位元組，先寫高位元組。
WriteLongAsync(Int64)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteShort(Int32)	將 a `short` 寫入檔案為兩個位元組，先寫高位元組。
WriteShortAsync(Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteUTF(String)	以修改過的 UTF-8 編碼，以機器獨立的方式寫入字串。
WriteUTFAsync(String)	此類別的實例同時支援對隨機存取檔案的讀寫。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別的實例同時支援對隨機存取檔案的讀寫。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	此類別的實例同時支援對隨機存取檔案的讀寫。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadBooleanAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadByteAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadCharAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadDoubleAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadFloatAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadFullyAsync(IDataInput, Byte[], Int32, Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadFullyAsync(IDataInput, Byte[])	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadIntAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadLineAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadLongAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadShortAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUnsignedByteAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUnsignedShortAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
ReadUTFAsync(IDataInput)	此類別的實例同時支援對隨機存取檔案的讀寫。
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)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteBytesAsync(IDataOutput, String)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteCharAsync(IDataOutput, Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteCharsAsync(IDataOutput, String)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteDoubleAsync(IDataOutput, Double)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteFloatAsync(IDataOutput, Single)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteIntAsync(IDataOutput, Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteLongAsync(IDataOutput, Int64)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteShortAsync(IDataOutput, Int32)	此類別的實例同時支援對隨機存取檔案的讀寫。
WriteUTFAsync(IDataOutput, String)	此類別的實例同時支援對隨機存取檔案的讀寫。

適用於