System.Collections.IList.cs

#region 程序集 mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\mscorlib.dll
#endregion

using System.Reflection;
using System.Runtime.InteropServices;

namespace System.Collections
{
    //
    // 摘要:
    //     表示可按照索引单独访问的对象的非泛型集合。
    [ComVisible(true)]
    [DefaultMember("Item")]
    public interface IList : ICollection, IEnumerable
    {
        //
        // 摘要:
        //     获取或设置位于指定索引处的元素。
        //
        // 参数:
        //   index:
        //     要获得或设置的元素从零开始的索引。
        //
        // 返回结果:
        //     位于指定索引处的元素。
        //
        // 异常:
        //   T:System.ArgumentOutOfRangeException:
        //     index 不是 System.Collections.IList 中的有效索引。
        //
        //   T:System.NotSupportedException:
        //     设置该属性，而且 System.Collections.IList 为只读。
        object this[int index] { get; set; }

        //
        // 摘要:
        //     获取一个值，该值指示 System.Collections.IList 是否为只读。
        //
        // 返回结果:
        //     如果 System.Collections.IList 为只读，则为 true；否则为 false。
        bool IsReadOnly { get; }
        //
        // 摘要:
        //     获取一个值，该值指示 System.Collections.IList 是否具有固定大小。
        //
        // 返回结果:
        //     如果 System.Collections.IList 具有固定大小，则为 true；否则为 false。
        bool IsFixedSize { get; }

        //
        // 摘要:
        //     将某项添加到 System.Collections.IList 中。
        //
        // 参数:
        //   value:
        //     要添加到 System.Collections.IList 的对象。
        //
        // 返回结果:
        //     新元素所插入到的位置，或为 -1 以指示未将该项插入到集合中。
        //
        // 异常:
        //   T:System.NotSupportedException:
        //     System.Collections.IList 为只读。 - 或 - System.Collections.IList 具有固定大小。
        int Add(object value);
        //
        // 摘要:
        //     从 System.Collections.IList 中移除所有项。
        //
        // 异常:
        //   T:System.NotSupportedException:
        //     System.Collections.IList 为只读。
        void Clear();
        //
        // 摘要:
        //     确定 System.Collections.IList 是否包含特定值。
        //
        // 参数:
        //   value:
        //     要在 System.Collections.IList 中查找的对象。
        //
        // 返回结果:
        //     如果在 System.Collections.IList 中找到 System.Object，则为 true；否则为 false。
        bool Contains(object value);
        //
        // 摘要:
        //     确定 System.Collections.IList 中特定项的索引。
        //
        // 参数:
        //   value:
        //     要在 System.Collections.IList 中查找的对象。
        //
        // 返回结果:
        //     如果在列表中找到，则为 value 的索引；否则为 -1。
        int IndexOf(object value);
        //
        // 摘要:
        //     将一个项插入指定索引处的 System.Collections.IList。
        //
        // 参数:
        //   index:
        //     从零开始的索引，应在该位置插入 value。
        //
        //   value:
        //     要插入 System.Collections.IList 的对象。
        //
        // 异常:
        //   T:System.ArgumentOutOfRangeException:
        //     index 不是 System.Collections.IList 中的有效索引。
        //
        //   T:System.NotSupportedException:
        //     System.Collections.IList 为只读。 - 或 - System.Collections.IList 具有固定大小。
        //
        //   T:System.NullReferenceException:
        //     value 在 System.Collections.IList 中是 null 引用。
        void Insert(int index, object value);
        //
        // 摘要:
        //     从 System.Collections.IList 中移除特定对象的第一个匹配项。
        //
        // 参数:
        //   value:
        //     要从 System.Collections.IList 中移除的对象。
        //
        // 异常:
        //   T:System.NotSupportedException:
        //     System.Collections.IList 为只读。 - 或 - System.Collections.IList 具有固定大小。
        void Remove(object value);
        //
        // 摘要:
        //     移除指定索引处的 System.Collections.IList 项。
        //
        // 参数:
        //   index:
        //     要移除的项的从零开始的索引。
        //
        // 异常:
        //   T:System.ArgumentOutOfRangeException:
        //     index 不是 System.Collections.IList 中的有效索引。
        //
        //   T:System.NotSupportedException:
        //     System.Collections.IList 为只读。 - 或 - System.Collections.IList 具有固定大小。
        void RemoveAt(int index);
    }
}