CopyOnWriteArrayList 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個執行緒安全的變體， java.util.ArrayList 所有變異操作（add、 set、 等）皆透過製作底層陣列的全新副本來實作。
[Android.Runtime.Register("java/util/concurrent/CopyOnWriteArrayList", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class CopyOnWriteArrayList : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IList, Java.Util.IRandomAccess[<Android.Runtime.Register("java/util/concurrent/CopyOnWriteArrayList", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type CopyOnWriteArrayList = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IList
interface ICollection
interface IIterable
interface ISequencedCollection
interface IRandomAccess- 繼承
- 屬性
- 實作
備註
一個執行緒安全的變體， java.util.ArrayList 所有變異操作（add、 set、 等）皆透過製作底層陣列的全新副本來實作。
這通常成本過高，但當遍歷操作數量遠多於突變時，這可能比替代方案更有效<><>率，且當你無法或不想同步遍歷，但又需要避免並行執行緒間的干擾時，這很有用。 「快照」式迭代器方法是參考建立迭代器時陣列的狀態。 這個陣列在迭代器的壽命期間從未改變，因此干擾不可能，且迭代器保證不會拋出 ConcurrentModificationException。 迭代器不會反映自建立以來對清單的新增、移除或變更。 不支援對迭代器本身remove（、 set和 add）進行元素變更操作。 這些方法拋出 UnsupportedOperationException。
所有元素皆被允許，包括 null。
記憶體一致性效應：與其他並行集合一樣，執行緒中在將物件放入 CopyOnWriteArrayList<i><> 之前/i 之前的動作，發生在該元素CopyOnWriteArrayList從另一個執行緒中移除後。
此類別是 Java 集合框架的成員。
已在1.5中新增。
的 java.util.concurrent.CopyOnWriteArrayListJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| CopyOnWriteArrayList() |
會產生一個空清單。 |
| CopyOnWriteArrayList(ICollection) |
建立包含指定集合元素的清單，依照集合迭代器回傳的順序排列。 |
| CopyOnWriteArrayList(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| CopyOnWriteArrayList(Object[]) |
建立一個包含該陣列副本的清單。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| First |
待補充 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
若此清單中無元素，則回傳 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個執行緒安全的變體， |
| JniPeerMembers |
一個執行緒安全的變體， |
| Last |
待補充 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Add(Int32, Object) |
將指定元素插入此列表中指定的位置。 |
| Add(Object) |
將指定元素附加到此列表的末尾。 |
| AddAll(ICollection) |
將指定集合中的所有元素附加到該清單末尾，依照指定集合迭代器回傳的順序。 |
| AddAll(Int32, ICollection) |
將指定集合中的所有元素插入此清單，從指定位置開始。 |
| AddAllAbsent(ICollection) |
將指定集合中尚未包含於此清單中的所有元素，依照該集合迭代器回傳的順序，附加到清單末尾。 |
| AddFirst(Object) |
待補充 |
| AddIfAbsent(Object) |
若不存在，則附加元素。 |
| AddLast(Object) |
待補充 |
| Clear() |
移除此清單中的所有元素。 |
| Clone() |
回傳一份淺薄的清單副本。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個執行緒安全的變體， |
| Contains(Object) |
如果此清單包含指定元素，則回傳 |
| ContainsAll(ICollection) |
若此清單包含指定集合的所有元素，則回傳 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個執行緒安全的變體， |
| Equals(Object) |
一個執行緒安全的變體， |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| ForEach(IConsumer) |
一個執行緒安全的變體， |
| Get(Int32) |
待補充 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| IndexOf(Object, Int32) |
回傳該列表中指定元素首次出現的索引，從 前向搜尋， |
| IndexOf(Object) |
待補充 |
| Iterator() |
回傳一個按正確順序處理此列表中元素的迭代器。 |
| JavaFinalize() |
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| LastIndexOf(Object, Int32) |
回傳該列表中指定元素最後出現的索引，從 回溯搜尋 |
| LastIndexOf(Object) |
待補充 |
| ListIterator() |
待補充 |
| ListIterator(Int32) |
待補充 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Remove(Int32) |
移除該列表中指定位置的元素。 |
| Remove(Object) |
如果該元素存在，則會從列表中移除該元素的首次出現。 |
| RemoveAll(ICollection) |
從此清單中移除指定集合中所有元素。 |
| RemoveFirst() |
待補充 |
| RemoveIf(IPredicate) |
一個執行緒安全的變體， |
| RemoveLast() |
待補充 |
| ReplaceAll(IUnaryOperator) |
一個執行緒安全的變體， |
| RetainAll(ICollection) |
僅保留此列表中包含於指定集合中的元素。 |
| Reversed() |
待補充 |
| Set(Int32, Object) |
將列表中指定位置的元素替換為指定的元素。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個執行緒安全的變體， |
| Size() |
傳回此清單中的項目數目。 |
| Sort(IComparator) |
一個執行緒安全的變體， |
| Spliterator() |
回傳此列表中元素的 a |
| SubList(Int32, Int32) |
回傳此列表中介於 |
| ToArray() |
回傳一個陣列，包含此列表中所有元素，依序排列（從第一個到最後一個元素）。 |
| ToArray(Object[]) |
回傳一個包含此列表中所有元素的陣列，按正確順序（從第一個到最後一個元素）;回傳陣列的執行時型別即為指定陣列的類型。 |
| 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() |
一個執行緒安全的變體， |
| IJavaPeerable.Finalized() |
一個執行緒安全的變體， |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個執行緒安全的變體， |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個執行緒安全的變體， |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個執行緒安全的變體， |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個執行緒安全的變體， |
| IJavaPeerable.UnregisterFromRuntime() |
一個執行緒安全的變體， |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個執行緒安全的變體， |
| ToEnumerable(IIterable) |
一個執行緒安全的變體， |
| ToEnumerable<T>(IIterable) |
一個執行緒安全的變體， |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |