Leggi in inglese

Condividi tramite

IList Interfaccia

  • Riferimento

Definizione

Spazio dei nomi:
System.Collections
Assembly:
mscorlib.dll, System.Runtime.dll
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Rappresenta una raccolta non generica di oggetti a cui è possibile accedere singolarmente in base all'indice.

C# 
public interface IList : System.Collections.ICollection
C# 
[System.Runtime.InteropServices.ComVisible(true)]
public interface IList : System.Collections.ICollection
Derivato
Attributi
ComVisibleAttribute
Implementazioni
ICollection IEnumerable

Esempio

Nell'esempio seguente viene illustrata l'implementazione dell'interfaccia IList per creare un semplice elenco a dimensione fissa.

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

Commenti

IList è un discendente dell'interfaccia ICollection ed è l'interfaccia di base di tutti gli elenchi non generici. IList implementazioni rientrano in tre categorie: sola lettura, dimensione fissa e dimensione variabile. Impossibile modificare un IList di sola lettura. Un IList a dimensione fissa non consente l'aggiunta o la rimozione di elementi, ma consente la modifica degli elementi esistenti. Un IList di dimensioni variabili consente l'aggiunta, la rimozione e la modifica degli elementi.

Per la versione generica di questa interfaccia, vedere System.Collections.Generic.IList<T>.

Proprietà

Count

Ottiene il numero di elementi contenuti nella ICollection.

(Ereditato da ICollection)
IsFixedSize

Ottiene un valore che indica se la IList ha una dimensione fissa.
IsReadOnly

Ottiene un valore che indica se il IList è di sola lettura.
IsSynchronized

Ottiene un valore che indica se l'accesso al ICollection è sincronizzato (thread-safe).

(Ereditato da ICollection)
Item[Int32]

Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al ICollection.

(Ereditato da ICollection)

Metodi

Add(Object)

Aggiunge un elemento al IList.
Clear()

Rimuove tutti gli elementi dal IList.
Contains(Object)

Determina se il IList contiene un valore specifico.
CopyTo(Array, Int32)

Copia gli elementi del ICollection in un Array, a partire da un particolare indice Array.

(Ereditato da ICollection)
GetEnumerator()

Restituisce un enumeratore che scorre un insieme.

(Ereditato da IEnumerable)
IndexOf(Object)

Determina l'indice di un elemento specifico nel IList.
Insert(Int32, Object)

Inserisce un elemento nella IList in corrispondenza dell'indice specificato.
Remove(Object)

Rimuove la prima occorrenza di un oggetto specifico dal IList.
RemoveAt(Int32)

Rimuove l'elemento IList in corrispondenza dell'indice specificato.

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un IEnumerable al tipo specificato.
OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)

Abilita la parallelizzazione di una query.
AsQueryable(IEnumerable)

Converte un IEnumerable in un IQueryable.

Si applica a

Prodotto Versioni
.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

Vedi anche