Vector 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
该 Vector 类实现对象的可增长数组。
[Android.Runtime.Register("java/util/Vector", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class Vector : Java.Util.AbstractList, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IRandomAccess
[<Android.Runtime.Register("java/util/Vector", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type Vector = class
inherit AbstractList
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IList
interface ICollection
interface IIterable
interface ISequencedCollection
interface IRandomAccess
- 继承
- 派生
- 特性
- 实现
注解
该 Vector 类实现对象的可增长数组。 与数组一样,它包含可以使用整数索引访问的组件。 但是,可以根据需要增大或缩小大小 Vector ,以适应在创建项目后 Vector 添加和删除项。
每个向量都尝试通过维护 a capacity 和 a capacityIncrement来优化存储管理。 它 capacity 始终与向量大小一样大;它通常更大,因为随着组件添加到向量中,矢量的存储以区块大小 capacityIncrement增加。 应用程序可以在插入大量组件之前增加向量容量;这会减少增量重新分配的数量。
此类#iterator() iterator#listIterator(int) listIterator和方法返回的迭代器是 <em>故障快速</em>:如果在创建迭代器后随时对矢量进行结构修改,则迭代器将引发ListIterator#remove() remove迭代器本身ListIterator#add(Object) add或ConcurrentModificationException方法以外的任何方式。 因此,面对并发修改,迭代器会在将来不确定的时间快速、干净地失败,而不是冒着任意的不确定行为的风险。
Enumeration Enumerations该方法#elements() elements返回的 < em>不是</em> 故障快速;如果在创建枚举后随时在结构上修改 Vector,则枚举的结果是未定义的。
请注意,迭代器的故障快速行为无法保证,一般来说,在出现非同步并发修改时,无法做出任何硬保证。 故障快速迭代器会尽力引发 ConcurrentModificationException 。 因此,编写依赖于此异常的程序的正确性是错误的: 迭代器的故障快速行为应仅用于检测 bug。
从 Java 2 平台 v1.2 开始,此类进行了改造以实现List接口,使其成为 Java 集合框架的成员。 与新的集合实现不同, Vector 同步。 如果不需要线程安全实现,建议使用 ArrayList 代替 Vector。
在 1.0 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| Vector() |
构造一个空向量,以便其内部数据数组的大小 |
| Vector(ICollection) |
构造一个包含指定集合的元素的向量,其顺序由集合的迭代器返回。 |
| Vector(Int32, Int32) |
构造具有指定初始容量和容量增量的空向量。 |
| Vector(Int32) |
构造具有指定初始容量的空向量,其容量增量等于零。 |
| Vector(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| CapacityIncrement |
当向量的大小大于其容量时,矢量的容量会自动递增的量。 |
| Class |
返回此 |
| ElementCount |
此 |
| ElementData |
将矢量的组件存储到的数组缓冲区。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsEmpty |
如果此集合不包含任何元素,则返回 true。 (继承自 AbstractCollection) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| ModCount |
此列表在 结构上修改的次数。 (继承自 AbstractList) |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| Add(Int32, Object) |
在此列表中指定位置插入指定元素(可选操作)。 (继承自 AbstractList) |
| Add(Object) |
确保此集合包含指定的元素(可选操作)。 (继承自 AbstractCollection) |
| AddAll(ICollection) |
将指定集合中的所有元素添加到此集合(可选操作)。 (继承自 AbstractCollection) |
| AddAll(Int32, ICollection) |
将指定集合中的所有元素插入到指定位置(可选操作)的此列表中。 (继承自 AbstractList) |
| AddElement(Object) |
将指定的组件添加到此向量末尾,使其大小增加一个。 |
| Capacity() |
返回此向量的当前容量。 |
| Clear() |
从此集合中删除所有元素(可选操作)。 (继承自 AbstractCollection) |
| Clone() |
返回此向量的克隆。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Contains(Object) |
如果此集合包含指定的元素,则返回 true。 (继承自 AbstractCollection) |
| ContainsAll(ICollection) |
如果此集合包含指定集合中的所有元素,则返回 true。 (继承自 AbstractCollection) |
| CopyInto(Object[]) |
将此矢量的组件复制到指定的数组中。 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| ElementAt(Int32) |
返回指定索引处的组件。 |
| Elements() |
返回此向量组件的枚举。 |
| EnsureCapacity(Int32) |
如有必要,增加此向量的容量,以确保它可以容纳至少由最小容量参数指定的组件数。 |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| FirstElement() |
返回此向量的第一个分量(索引处 |
| ForEach(IConsumer) |
对可迭代的每个元素执行给定操作,直到处理完所有元素或该操作引发异常。 |
| Get(Int32) |
返回此向量中位于指定位置的元素。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| IndexOf(Object, Int32) |
返回此向量中指定元素的第一个匹配项的索引,从中搜索 |
| IndexOf(Object) |
返回此列表中指定元素的第一个匹配项的索引,如果此列表不包含该元素,则返回 -1。 (继承自 AbstractList) |
| InsertElementAt(Object, Int32) |
将指定对象作为组件插入到此向量中的指定位置。 |
| Iterator() |
按正确的顺序返回此列表中的元素的迭代器。 (继承自 AbstractList) |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| LastElement() |
返回向量的最后一个组件。 |
| LastIndexOf(Object, Int32) |
返回此向量中指定元素的最后一个匹配项的索引、从 |
| LastIndexOf(Object) |
返回此列表中指定元素的最后一个匹配项的索引;如果此列表不包含该元素,则返回 -1。 (继承自 AbstractList) |
| ListIterator() |
返回此列表中元素的列表迭代器(按正确的顺序)。 (继承自 AbstractList) |
| ListIterator(Int32) |
返回一个列表迭代器,该列表的元素(按正确的顺序),从列表中的指定位置开始。 (继承自 AbstractList) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Remove(Int32) |
删除此列表中指定位置处的元素(可选操作)。 (继承自 AbstractList) |
| Remove(Object) |
从此集合中删除指定元素的单个实例(如果存在)(可选操作)。 (继承自 AbstractCollection) |
| RemoveAll(ICollection) |
删除指定集合中包含的所有此集合元素(可选操作)。 (继承自 AbstractCollection) |
| RemoveAllElements() |
从此向量中删除所有组件,并将其大小设置为零。 |
| RemoveElement(Object) |
从此向量中删除自变量的第一个(最低索引)匹配项。 |
| RemoveElementAt(Int32) |
删除指定索引处的组件。 |
| RemoveIf(IPredicate) |
删除满足给定谓词的此集合的所有元素。 |
| RemoveRange(Int32, Int32) |
从此列表中删除索引介于、非独占和 |
| ReplaceAll(IUnaryOperator) |
将此列表的每个元素替换为将运算符应用于该元素的结果。 |
| RetainAll(ICollection) |
仅保留指定集合中包含的此集合中的元素(可选操作)。 (继承自 AbstractCollection) |
| Set(Int32, Object) |
将此列表中位于指定位置的元素替换为指定元素(可选操作)。 (继承自 AbstractList) |
| SetElementAt(Object, Int32) |
将指定此向量处 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| SetSize(Int32) |
设置此向量的大小。 |
| Size() |
返回此向量中的组件数。 |
| Sort(IComparator) |
使用指定的比较器对此向量元素进行排序。 |
| Spliterator() |
在此列表中的元素上创建 em 后期绑定</em> 和 <em>故障快速</em><。> |
| SubList(Int32, Int32) |
返回指定 fromIndex、非独占和 toIndex 之间的此列表部分的视图。 (继承自 AbstractList) |
| ToArray() |
返回一个数组,其中包含此集合中的所有元素。 (继承自 AbstractCollection) |
| ToArray(Object[]) |
返回一个数组,其中包含此集合中的所有元素;返回的数组的运行时类型是指定数组的运行时类型。 (继承自 AbstractCollection) |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| TrimToSize() |
剪裁此矢量的容量,以成为矢量的当前大小。 |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| ToEnumerable(IIterable) |
返回IEnumerable循环访问JavaIIterable,允许 |
| ToEnumerable<T>(IIterable) |
返回一个IEnumerable<T>循环访问JavaIIterable,将每个元素封送给 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |