IList 接口

定义

[Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IList : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ICollection

[Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IList : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISequencedCollection

[<Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IList = interface
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

[<Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IList = interface
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISequencedCollection

派生

Java.Util.AbstractList

Java.Util.ArrayList

Java.Util.Concurrent.CopyOnWriteArrayList

Java.Util.LinkedList

Java.Util.Vector

属性

RegisterAttribute JavaTypeParametersAttribute

实现

IJavaObject IJavaPeerable IIterable ICollection IDisposable ISequencedCollection

注解

有序集合，用户可精确控制插入每个元素列表中的位置。 用户可以按元素的整数索引（在列表中的位置）访问元素，并搜索列表中的元素。

与集不同，列表通常允许重复元素。 更正式的是，列表通常允许对元素 e1 ， e2 因此 e1.equals(e2)，如果允许 null 元素，它们通常允许多个 null 元素。 用户尝试插入重复项时，可能希望实现禁止重复项的列表并不不可思议，但我们希望这种用法很少见。

接口List对接口、、removeequals和hashCode方法的协定iteratoradd规定了其他规定（超出接口中指定的Collection规定）。 为了方便起见，此处还包括其他继承方法的声明。

该 List 接口提供四种方法用于对列表元素进行位置（索引）访问。 列表（如Java数组）基于零。 请注意，这些操作可能与某些实现的索引值成正比（ LinkedList 例如类）。 因此，如果调用方不知道实现，则循环访问列表中的元素通常最好通过它进行索引。

除了接口提供的正常操作Iterator外，该List接口还提供一个名为 a ListIterator的特殊迭代器，该迭代器允许元素插入和替换，以及双向访问。 提供了一种方法来获取列表迭代器，该迭代器从列表中的指定位置开始。

该 List 接口提供两种方法来搜索指定的对象。 从性能的角度来看，应谨慎使用这些方法。 在许多实现中，它们将执行昂贵的线性搜索。

该 List 接口提供了两种方法，用于在列表中的任意点高效插入和删除多个元素。

注意：虽然允许列表包含自己作为元素，但建议格外小心： equals 此类列表上不再明确定义方法和 hashCode 方法。

某些列表实现对它们可能包含的元素有限制。 例如，某些实现禁止 null 元素，有些实现对其元素的类型有限制。 尝试添加不符合资格的元素会引发未检查的异常，通常 NullPointerException 或 ClassCastException。 尝试查询是否存在不符合资格的元素可能会引发异常，或者可能只返回 false;某些实现将展示前一种行为，一些实现将展示后者。 更通常，尝试对不合格元素执行操作，该元素的完成不会导致不合格元素插入列表中可能会引发异常，或者在实现选项中成功。 此接口的规范中将此类异常标记为“可选”。

<h2>“unmodifiable”>Unmodifiable Lists</h2>

静态List#of(Object...) List.ofList#copyOf List.copyOf工厂方法提供了一种创建不可修改列表的便捷方法。 List这些方法创建的实例具有以下特征：

<ul><li>它们是 <不可>修改<的/i>。 无法添加、删除或替换元素。 在列表中调用任何可变器方法将始终引发 UnsupportedOperationException 。 但是，如果包含的元素本身是可变的，这可能会导致列表的内容似乎发生变化。 <li>他们禁止 null 元素。 尝试使用 null 元素创建它们将导致 NullPointerException。 <如果>所有元素都是可序列化的，则 li 它们可序列化。 <li>列表中的元素顺序与提供的参数的顺序或提供的数组中的元素的顺序相同。 <li>列表及其 #subList(int, int) subList 视图实现 RandomAccess 接口。 <li>它们是基于值的。 程序员应将 #equals（Object）等于可交换的实例视为可互换的实例，不应将其用于同步，或者可能发生不可预知的行为。 例如，在将来的版本中，同步可能会失败。 调用方不应假设返回的实例的标识。 工厂可以免费创建新实例或重复使用现有实例。 <li>它们按 序列化窗体 页上的指定进行序列化。 </ul>

已在 1.2 中添加。

Java文档java.util.List。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。