使用英语阅读

通过

IList 接口

  • 参考

定义

命名空间:
System.Collections
程序集:
mscorlib.dll, System.Runtime.dll
程序集:
netstandard.dll, System.Runtime.dll
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

表示可由索引单独访问的对象的非泛型集合。

C# 
public interface IList : System.Collections.ICollection
C# 
[System.Runtime.InteropServices.ComVisible(true)]
public interface IList : System.Collections.ICollection
派生
属性
ComVisibleAttribute
实现
ICollection IEnumerable

示例

以下示例演示了用于创建简单固定大小的列表的 IList 接口的实现。

C# 
using System;
using System.Collections;

class Program
{
    static void Main()
    {
        var test = new SimpleList();

        // Populate the List.
        Console.WriteLine("Populate the List");
        test.Add("one");
        test.Add("two");
        test.Add("three");
        test.Add("four");
        test.Add("five");
        test.Add("six");
        test.Add("seven");
        test.Add("eight");
        test.PrintContents();
        Console.WriteLine();

        // Remove elements from the list.
        Console.WriteLine("Remove elements from the list");
        test.Remove("six");
        test.Remove("eight");
        test.PrintContents();
        Console.WriteLine();

        // Add an element to the end of the list.
        Console.WriteLine("Add an element to the end of the list");
        test.Add("nine");
        test.PrintContents();
        Console.WriteLine();

        // Insert an element into the middle of the list.
        Console.WriteLine("Insert an element into the middle of the list");
        test.Insert(4, "number");
        test.PrintContents();
        Console.WriteLine();

        // Check for specific elements in the list.
        Console.WriteLine("Check for specific elements in the list");
        Console.WriteLine($"List contains \"three\": {test.Contains("three")}");
        Console.WriteLine($"List contains \"ten\": {test.Contains("ten")}");
    }
}

class SimpleList : IList
{
    private object[] _contents = new object[8];
    private int _count;

    public SimpleList()
    {
        _count = 0;
    }

    // IList Members
    public int Add(object value)
    {
        if (_count < _contents.Length)
        {
            _contents[_count] = value;
            _count++;

            return (_count - 1);
        }

        return -1;
    }

    public void Clear()
    {
        _count = 0;
    }

    public bool Contains(object value)
    {
        for (int i = 0; i < Count; i++)
        {
            if (_contents[i] == value)
            {
                return true;
            }
        }
        return false;
    }

    public int IndexOf(object value)
    {
        for (int i = 0; i < Count; i++)
        {
            if (_contents[i] == value)
            {
                return i;
            }
        }
        return -1;
    }

    public void Insert(int index, object value)
    {
        if ((_count + 1 <= _contents.Length) && (index < Count) && (index >= 0))
        {
            _count++;

            for (int i = Count - 1; i > index; i--)
            {
                _contents[i] = _contents[i - 1];
            }
            _contents[index] = value;
        }
    }

    public bool IsFixedSize
    {
        get
        {
            return true;
        }
    }

    public bool IsReadOnly
    {
        get
        {
            return false;
        }
    }

    public void Remove(object value)
    {
        RemoveAt(IndexOf(value));
    }

    public void RemoveAt(int index)
    {
        if ((index >= 0) && (index < Count))
        {
            for (int i = index; i < Count - 1; i++)
            {
                _contents[i] = _contents[i + 1];
            }
            _count--;
        }
    }

    public object this[int index]
    {
        get
        {
            return _contents[index];
        }
        set
        {
            _contents[index] = value;
        }
    }

    // ICollection members.

    public void CopyTo(Array array, int index)
    {
        for (int i = 0; i < Count; i++)
        {
            array.SetValue(_contents[i], index++);
        }
    }

    public int Count
    {
        get
        {
            return _count;
        }
    }

    public bool IsSynchronized
    {
        get
        {
            return false;
        }
    }

    // Return the current instance since the underlying store is not
    // publicly available.
    public object SyncRoot
    {
        get
        {
            return this;
        }
    }

    // IEnumerable Members

    public IEnumerator GetEnumerator()
    {
        // Refer to the IEnumerator documentation for an example of
        // implementing an enumerator.
        throw new NotImplementedException("The method or operation is not implemented.");
    }

    public void PrintContents()
    {
        Console.WriteLine($"List has a capacity of {_contents.Length} and currently has {_count} elements.");
        Console.Write("List contents:");
        for (int i = 0; i < Count; i++)
        {
            Console.Write($" {_contents[i]}");
        }
        Console.WriteLine();
    }
}

// This code produces output similar to the following:
// Populate the List:
// List has a capacity of 8 and currently has 8 elements.
// List contents: one two three four five six seven eight
//
// Remove elements from the list:
// List has a capacity of 8 and currently has 6 elements.
// List contents: one two three four five seven
//
// Add an element to the end of the list:
// List has a capacity of 8 and currently has 7 elements.
// List contents: one two three four five seven nine
//
// Insert an element into the middle of the list:
// List has a capacity of 8 and currently has 8 elements.
// List contents: one two three four number five seven nine
//
// Check for specific elements in the list:
// List contains "three": True
// List contains "ten": False

注解

IList 是 ICollection 接口的后代，是所有非泛型列表的基本接口。 IList 实现分为三类：只读、固定大小和可变大小。 无法修改只读 IList。 固定大小的 IList 不允许添加或删除元素，但它允许修改现有元素。 可变大小的 IList 允许添加、删除和修改元素。

有关此接口的通用版本，请参阅 System.Collections.Generic.IList<T>。

属性

Count

获取 ICollection中包含的元素数。

(继承自 ICollection)
IsFixedSize

获取一个值，该值指示 IList 是否具有固定大小。
IsReadOnly

获取一个值，该值指示 IList 是否为只读。
IsSynchronized

获取一个值，该值指示是否同步对 ICollection 的访问（线程安全）。

(继承自 ICollection)
Item[Int32]

获取或设置指定索引处的元素。
SyncRoot

获取可用于同步对 ICollection的访问的对象。

(继承自 ICollection)

方法

Add(Object)

将项添加到 IList。
Clear()

从 IList中删除所有项。
Contains(Object)

确定 IList 是否包含特定值。
CopyTo(Array, Int32)

从特定 Array 索引开始，将 ICollection 的元素复制到 Array。

(继承自 ICollection)
GetEnumerator()

返回循环访问集合的枚举器。

(继承自 IEnumerable)
IndexOf(Object)

确定 IList中特定项的索引。
Insert(Int32, Object)

将项插入到指定索引处的 IList。
Remove(Object)

从 IList中删除特定对象的第一个匹配项。
RemoveAt(Int32)

删除指定索引处的 IList 项。

扩展方法

Cast<TResult>(IEnumerable)

将 IEnumerable 的元素强制转换为指定类型。
OfType<TResult>(IEnumerable)

根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)

启用查询的并行化。
AsQueryable(IEnumerable)

将 IEnumerable 转换为 IQueryable。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另请参阅