Partilhar via


Generic Interfaces (C# Programming Guide)

Muitas vezes é útil definir interfaces para classes de coleção genérica ou para as classes genéricas que representam os itens na coleção. A preferência para classes genéricas é usar interfaces genéricas, como IComparable<T> em vez de IComparable, a fim de evitar a conversão boxing e unboxing operações em valor tipos. A.NET Framework class library define várias interfaces genéricas para uso com as classes de coleção de System.Collections.Generic namespace.

Quando uma interface é especificada como uma restrição em um parâmetro de tipo, somente os tipos que implementam a interface podem ser usados. O seguinte código exemplo mostra um SortedList<T> classe que deriva do GenericList<T> classe. Para obter mais informações, consulte Introduction to Generics (C# Programming Guide). SortedList<T>Adiciona a restrição where T : IComparable<T>. Isso permite que o BubbleSort método no SortedList<T> para usar a classe genérica CompareTo método na lista de elementos. Neste exemplo, elementos de lista são uma classe simples, Person, que implementa IComparable<Person>.

//Type parameter T in angle brackets.
public class GenericList<T> : System.Collections.Generic.IEnumerable<T>
{
    protected Node head;
    protected Node current = null;

    // Nested class is also generic on T
    protected class Node
    {
        public Node next;
        private T data;  //T as private member datatype

        public Node(T t)  //T used in non-generic constructor
        {
            next = null;
            data = t;
        }

        public Node Next
        {
            get { return next; }
            set { next = value; }
        }

        public T Data  //T as return type of property
        {
            get { return data; }
            set { data = value; }
        }
    }

    public GenericList()  //constructor
    {
        head = null;
    }

    public void AddHead(T t)  //T as method parameter type
    {
        Node n = new Node(t);
        n.Next = head;
        head = n;
    }

    // Implementation of the iterator
    public System.Collections.Generic.IEnumerator<T> GetEnumerator()
    {
        Node current = head;
        while (current != null)
        {
            yield return current.Data;
            current = current.Next;
        }
    }

    // IEnumerable<T> inherits from IEnumerable, therefore this class 
    // must implement both the generic and non-generic versions of 
    // GetEnumerator. In most cases, the non-generic method can 
    // simply call the generic method.
    System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
    {
        return GetEnumerator();
    }
}

public class SortedList<T> : GenericList<T> where T : System.IComparable<T>
{
    // A simple, unoptimized sort algorithm that 
    // orders list elements from lowest to highest:

    public void BubbleSort()
    {
        if (null == head || null == head.Next)
        {
            return;
        }
        bool swapped;

        do
        {
            Node previous = null;
            Node current = head;
            swapped = false;

            while (current.next != null)
            {
                //  Because we need to call this method, the SortedList
                //  class is constrained on IEnumerable<T>
                if (current.Data.CompareTo(current.next.Data) > 0)
                {
                    Node tmp = current.next;
                    current.next = current.next.next;
                    tmp.next = current;

                    if (previous == null)
                    {
                        head = tmp;
                    }
                    else
                    {
                        previous.next = tmp;
                    }
                    previous = tmp;
                    swapped = true;
                }
                else
                {
                    previous = current;
                    current = current.next;
                }
            }
        } while (swapped);
    }
}

// A simple class that implements IComparable<T> using itself as the 
// type argument. This is a common design pattern in objects that 
// are stored in generic lists.
public class Person : System.IComparable<Person>
{
    string name;
    int age;

    public Person(string s, int i)
    {
        name = s;
        age = i;
    }

    // This will cause list elements to be sorted on age values.
    public int CompareTo(Person p)
    {
        return age - p.age;
    }

    public override string ToString()
    {
        return name + ":" + age;
    }

    // Must implement Equals.
    public bool Equals(Person p)
    {
        return (this.age == p.age);
    }
}

class Program
{
    static void Main()
    {
        //Declare and instantiate a new generic SortedList class.
        //Person is the type argument.
        SortedList<Person> list = new SortedList<Person>();

        //Create name and age values to initialize Person objects.
        string[] names = new string[] 
        { 
            "Franscoise", 
            "Bill", 
            "Li", 
            "Sandra", 
            "Gunnar", 
            "Alok", 
            "Hiroyuki", 
            "Maria", 
            "Alessandro", 
            "Raul" 
        };

        int[] ages = new int[] { 45, 19, 28, 23, 18, 9, 108, 72, 30, 35 };

        //Populate the list.
        for (int x = 0; x < 10; x++)
        {
            list.AddHead(new Person(names[x], ages[x]));
        }

        //Print out unsorted list.
        foreach (Person p in list)
        {
            System.Console.WriteLine(p.ToString());
        }
        System.Console.WriteLine("Done with unsorted list");

        //Sort the list.
        list.BubbleSort();

        //Print out sorted list.
        foreach (Person p in list)
        {
            System.Console.WriteLine(p.ToString());
        }
        System.Console.WriteLine("Done with sorted list");
    }
}

Várias interfaces podem ser especificados como restrições de um único tipo, como segue:

class Stack<T> where T : System.IComparable<T>, IEnumerable<T>
{
}

Uma interface pode definir mais de um parâmetro de tipo, como segue:

interface IDictionary<K, V>
{
}

As regras de herança que se aplicam às classes também se aplicam a interfaces:

interface IMonth<T> { }

interface IJanuary     : IMonth<int> { }  //No error
interface IFebruary<T> : IMonth<int> { }  //No error
interface IMarch<T>    : IMonth<T> { }    //No error
//interface IApril<T>  : IMonth<T, U> {}  //Error

Interfaces genéricas podem herdar de interfaces de não-genéricas, se a interface genérica é compensado-variant, o que significa que ele só usa seu parâmetro de tipo como um valor de retorno. No.Biblioteca de classe do NET Framework, IEnumerable<T> herda de IEnumerable porque IEnumerable<T> usa apenas T no valor de retorno de GetEnumerator e de Current getter de propriedade.

Classes concretas podem implementar interfaces de construído fechadas, como segue:

interface IBaseInterface<T> { }

class SampleClass : IBaseInterface<string> { }

Classes genéricas podem implementar interfaces genéricas ou interfaces de construído fechadas, contanto que a lista de parâmetros de classe fornece todos os argumentos necessários para a interface da seguinte maneira:

interface IBaseInterface1<T> { }
interface IBaseInterface2<T, U> { }

class SampleClass1<T> : IBaseInterface1<T> { }          //No error
class SampleClass2<T> : IBaseInterface2<T, string> { }  //No error

As regras que controlam a sobrecarga de método são os mesmos métodos em classes genéricas, genérico structs ou interfaces genéricas. Para obter mais informações, consulte Generic Methods (C# Programming Guide).

Consulte também

Referência

Introduction to Generics (C# Programming Guide)

interface (Referência de C#)

Conceitos

C# Programming Guide

Classes genéricas no .NET Framework