CopyOnWriteArraySet 類別

定義

命名空間:

Java.Util.Concurrent

組件:

Mono.Android.dll

一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。

[Android.Runtime.Register("java/util/concurrent/CopyOnWriteArraySet", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class CopyOnWriteArraySet : Java.Util.AbstractSet, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/util/concurrent/CopyOnWriteArraySet", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type CopyOnWriteArraySet = class
    inherit AbstractSet
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

AbstractCollection

AbstractSet

CopyOnWriteArraySet

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable ISerializable IDisposable

備註

一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 因此，它共享相同的基本特性： <ul><li>它最適合用於集合大小通常保持小、唯讀操作數量遠多於變異操作，且在遍歷過程中需要防止執行緒間的干擾。 <李>：它是安全的。 <li>變異運算（add、 set、 remove、等）成本高昂，因為它們通常涉及複製整個底層陣列。 <li>迭代器不支援變異 remove 操作。 <透過迭代器的 li>遍歷速度快，且不會受到其他執行緒的干擾。 迭代器依賴於構建時陣列的不變快照。 </ul>

<b>範例使用。</b> 以下程式碼草稿使用寫入時複製（copy-on-write）集合來維護一組處理程序物件，這些物件在狀態更新時執行某些動作。

{@code
            class Handler { void handle() { ... } }

            class X {
              private final CopyOnWriteArraySet<Handler> handlers
                = new CopyOnWriteArraySet<>();
              public void addHandler(Handler h) { handlers.add(h); }

              private long internalState;
              private synchronized void changeState() { internalState = ...; }

              public void update() {
                changeState();
                for (Handler handler : handlers)
                  handler.handle();
              }
            }}

此類別是 Java 集合框架的成員。

已在1.5中新增。

的 java.util.concurrent.CopyOnWriteArraySetJava 檔。

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

建構函式

名稱	Description
CopyOnWriteArraySet()	會產生一個空集合。
CopyOnWriteArraySet(ICollection)	建立包含指定集合所有元素的集合。
CopyOnWriteArraySet(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsEmpty	待補充 (繼承來源 AbstractCollection)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
JniPeerMembers	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Add(Object)	待補充 (繼承來源 AbstractCollection)
AddAll(ICollection)	待補充 (繼承來源 AbstractCollection)
Clear()	待補充 (繼承來源 AbstractCollection)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
Contains(Object)	待補充 (繼承來源 AbstractCollection)
ContainsAll(ICollection)	待補充 (繼承來源 AbstractCollection)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
Equals(Object)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
ForEach(IConsumer)	對可迭代的每個元素執行指定動作，直到所有元素處理完畢或動作拋出例外為止。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
Iterator()	回傳該集合中元素的迭代器，依加入順序排列。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Remove(Object)	待補充 (繼承來源 AbstractCollection)
RemoveAll(ICollection)	待補充 (繼承來源 AbstractCollection)
RemoveIf(IPredicate)	移除該集合中所有滿足該謂詞的元素。
RetainAll(ICollection)	待補充 (繼承來源 AbstractCollection)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
Size()	返回此集合中的元素數量。
Spliterator()	依元素加入順序回傳 a Spliterator 。
ToArray()	待補充 (繼承來源 AbstractCollection)
ToArray(Object[])	待補充 (繼承來源 AbstractCollection)
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()	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個 Set 在所有操作中使用內部的 Inite CopyOnWriteArrayList 。
ToEnumerable(IIterable)	回傳 和 IEnumerable ，會對 Java IIterable進行迭代，允許 foreach 和 LINQ 與 Java 集合類型一起使用。 每個元素都會從其 Java 實例編組到對應的受管理型別。
ToEnumerable<T>(IIterable)	回傳 和 IEnumerable<T> ，該 在 Java IIterable上迭代，將每個元素 集結為 T。 這使得 foreach LINQ 可以搭配 Java 集合類型一起使用。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。