RandomAccessFile 建構函式

定義

命名空間:: Java.IO

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
RandomAccessFile(File, String)	建立一個隨機存取檔案串流，用於讀取並可選擇寫入參數指定的 `File` 檔案。
RandomAccessFile(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
RandomAccessFile(String, String)	建立一個隨機存取檔案串流，用於讀取並可選擇寫入指定名稱的檔案。

RandomAccessFile(File, String)

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

[Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")]
public RandomAccessFile(Java.IO.File? file, string? mode);

[<Android.Runtime.Register(".ctor", "(Ljava/io/File;Ljava/lang/String;)V", "")>]
new Java.IO.RandomAccessFile : Java.IO.File * string -> Java.IO.RandomAccessFile

參數

file: File

檔案物件

mode: String

如上所述的存取模式

屬性: RegisterAttribute

例外狀況

FileNotFoundException

若檔案無法依照 mode開啟或建立。

IllegalArgumentException

若不是、、或 "rwd""rws" 。 "rw""r"mode

備註

建立一個隨機存取檔案串流，用於讀取並可選擇寫入參數指定的 File 檔案。會建立一個新 FileDescriptor 物件來表示這個檔案連線。

「mode」><c>mode</c> 參數指定檔案將以何種存取方式開啟。允許的數值及其意義如下：

<表格摘要=「允許存取模式，值與意義」tr><>< th align=“left”Value<>/th><th align=“left”>意義/<th></tr<>tr td><valign=“top”<"r">/td><td> 僅供閱讀。呼叫所得物件中任一 write 方法都會使 a java.io.IOException 被拋棄。 </td></tr<>tr td><valign=「top」><"rw"/td><td> 開啟以供閱讀與書寫。如果該檔案尚未存在，則會嘗試建立它。 </td></tr><tr td><valign=“top”"rws"<>/td td<>> 開啟用於讀寫，與相同"rw"，並且要求每次檔案內容或元資料的更新都必須同步寫入底層儲存裝置。 </td></tr><tr td><valign=“top”"rwd"  <>/td td<>> 打開讀取與寫入，與相同"rw"，並要求每次檔案內容更新都必須同步寫入底層儲存裝置。 </td></tr></table>

"rws"和 "rwd" 模式的運作方式類似java.nio.channels.FileChannel#force(boolean) force(boolean)類別java.nio.channels.FileChannel的方法，分別傳遞和 false的true參數，但它們總是適用於所有 I/O 操作，因此通常更有效率。如果檔案存在於本地儲存裝置上，當呼叫此類方法回傳時，可以保證該呼叫對檔案所做的所有變更都會寫入該裝置。這有助於確保系統當機時關鍵資訊不會遺失。如果檔案不存在於本地裝置，則無法提供此類保證。

此 "rwd" 模式可用來減少輸入輸出操作的數量。使用 "rwd" 時只需將檔案內容更新寫入儲存;使用 "rws" 時則需同時寫入檔案內容及其元資料，通常至少需要一次低階 I/O 操作。

若有安全管理器，則會以參數的路徑名稱file作為參數呼叫其checkRead方法，以確認是否允許讀取檔案。若模式允許寫入，則會呼叫安全管理器的方法 checkWrite ，並以路徑參數查看是否允許寫入檔案。

的 java.io.RandomAccessFile.RandomAccessFile(java.io.File, java.lang.String)Java 檔。

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

適用於

RandomAccessFile(IntPtr, JniHandleOwnership)

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

protected RandomAccessFile(IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.IO.RandomAccessFile : nativeint * Android.Runtime.JniHandleOwnership -> Java.IO.RandomAccessFile

參數

javaReference: IntPtr
nativeint

IntPtrA 包含一個 Java 原生介面（JNI）物件參考。

transfer: JniHandleOwnership

JniHandleOwnershipA 指示如何處理javaReference

備註

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

適用於

RandomAccessFile(String, String)

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

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")]
public RandomAccessFile(string? name, string? mode);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/lang/String;)V", "")>]
new Java.IO.RandomAccessFile : string * string -> Java.IO.RandomAccessFile