AtomicFile 類別

定義

命名空間:

Android.Util

組件:

Mono.Android.dll

輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。

[Android.Runtime.Register("android/util/AtomicFile", DoNotGenerateAcw=true)]
public class AtomicFile : Java.Lang.Object

[<Android.Runtime.Register("android/util/AtomicFile", DoNotGenerateAcw=true)>]
type AtomicFile = class
    inherit Object

繼承

Object

JavaObject

Object

AtomicFile

屬性

RegisterAttribute

備註

輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 如果你在舊版本的平台上需要這個功能，可以在 AndroidX 裡使用 androidx.core.util.AtomicFile 。

Atomic 檔案透過確保檔案在重新命名為原始檔案前，確保檔案已完全寫入並同步到磁碟，從而保證檔案完整性。 過去這是透過事先將原始檔案重新命名為備份檔案來完成，但這種方法無法處理檔案首次建立的情況。 這個類別也能妥善處理舊實作所建立的備份檔案。

原子檔案不賦予任何檔案鎖定語意。 當檔案可能同時被多個執行緒或程序存取或修改時，請勿使用此類別。 呼叫者負責在存取檔案時確保適當的互斥不變量。

Java 文件 android.util.AtomicFile。

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

建構函式

名稱	Description
AtomicFile(File)	為位於指定檔案路徑的檔案建立一個新的 AtomicFile。
AtomicFile(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
BaseFile	回傳路徑到基礎檔案。
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
JniPeerMembers	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
LastModifiedTime	取得原子檔案最後修改時間。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
Delete()	刪除原子檔案。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
Equals(Object)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FailWrite(Stream)	當你因某些原因未能寫入回傳的串流 #startWrite()時，請致電。
FailWriteAsync(Stream)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
FinishWrite(Stream)	當你成功完成對回傳 #startWrite()的串流後，請致電。
FinishWriteAsync(Stream)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OpenRead()	打開原子檔案來讀取。
ReadFully()	#openRead()方便的是，所有檔案內容會讀入一個位元組陣列，然後回傳。
ReadFullyAsync()	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
StartWrite()	對檔案重新開始寫入操作。
StartWriteAsync()	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
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)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	輔助類別用於對檔案執行原子操作，透過寫入新檔案並在寫入成功完成後將其重新命名為原檔案的位置。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。