Использование вариативности в универсальных методах-делегатах Func и Action (C# и Visual Basic)

В нижеприведенных примерах показано использование ковариации и контравариации в универсальных методах-делегатах Func и Action, позволяющее повторно использовать методы и обеспечивать большую гибкость кода.

Дополнительные сведения о ковариации и контравариации см. в разделе Вариативность в делегатах (C# и Visual Basic).

Использование делегатов с ковариантными параметрами типа

В следующем примере продемонстрировано преимущество использования поддержки ковариации в универсальных методах-делегатах Func. Метод FindByTitle принимает параметр типа String и возвращает объект типа Employee. Этот метод, однако, можно назначить делегату Func<String, Person> (Func(Of String, Person) в Visual Basic), поскольку Employee наследует Person.

' Simple hierarchy of classes. 
Public Class Person
End Class 

Public Class Employee
    Inherits Person
End Class 

Class Finder
    Public Shared Function FindByTitle(
        ByVal title As String) As Employee
        ' This is a stub for a method that returns 
        ' an employee that has the specified title. 
        Return New Employee
    End Function 

    Sub Test()
        ' Create an instance of the delegate without using variance. 
        Dim findEmployee As Func(Of String, Employee) =
            AddressOf FindByTitle

        ' The delegate expects a method to return Person, 
        ' but you can assign it a method that returns Employee. 
        Dim findPerson As Func(Of String, Person) =
            AddressOf FindByTitle

        ' You can also assign a delegate  
        ' that returns a more derived type to a delegate  
        ' that returns a less derived type.
        findPerson = findEmployee
    End Sub 
End Class
// Simple hierarchy of classes. 
public class Person { }
public class Employee : Person { }
class Program
{
    static Employee FindByTitle(String title)
    {
        // This is a stub for a method that returns 
        // an employee that has the specified title. 
        return new Employee();
    }

    static void Test()
    {
        // Create an instance of the delegate without using variance.
        Func<String, Employee> findEmployee = FindByTitle;

        // The delegate expects a method to return Person, 
        // but you can assign it a method that returns Employee.
        Func<String, Person> findPerson = FindByTitle;

        // You can also assign a delegate  
        // that returns a more derived type  
        // to a delegate that returns a less derived type.
        findPerson = findEmployee;

    }
}

Использование делегатов с контравариантными параметрами типа

В следующем примере продемонстрировано преимущество использования поддержки контравариации в универсальных методах-делегатах Action. Метод AddToContacts принимает параметр типа Person. Этот метод, однако, можно назначить делегату Action<Employee> ((Action(Of Employee) в Visual Basic), поскольку Employee наследует Person.

Public Class Person
End Class 

Public Class Employee
    Inherits Person
End Class 

Class AddressBook
    Shared Sub AddToContacts(ByVal person As Person)
        ' This method adds a Person object 
        ' to a contact list. 
    End Sub 

    Sub Test()
        ' Create an instance of the delegate without using variance. 
        Dim addPersonToContacts As Action(Of Person) =
            AddressOf AddToContacts

        ' The Action delegate expects  
        ' a method that has an Employee parameter, 
        ' but you can assign it a method that has a Person parameter 
        ' because Employee derives from Person. 
        Dim addEmployeeToContacts As Action(Of Employee) =
            AddressOf AddToContacts

        ' You can also assign a delegate  
        ' that accepts a less derived parameter  
        ' to a delegate that accepts a more derived parameter.
        addEmployeeToContacts = addPersonToContacts
    End Sub 
End Class
public class Person { }
public class Employee : Person { }
class Program
{
    static void AddToContacts(Person person)
    {
        // This method adds a Person object 
        // to a contact list.
    }

    static void Test()
    {
        // Create an instance of the delegate without using variance.
        Action<Person> addPersonToContacts = AddToContacts;

        // The Action delegate expects  
        // a method that has an Employee parameter, 
        // but you can assign it a method that has a Person parameter 
        // because Employee derives from Person.
        Action<Employee> addEmployeeToContacts = AddToContacts;

        // You can also assign a delegate  
        // that accepts a less derived parameter to a delegate  
        // that accepts a more derived parameter.
        addEmployeeToContacts = addPersonToContacts;
    }
}

См. также

Другие ресурсы

Ковариация и контравариация (C# и Visual Basic)

Универсальные шаблоны в платформе .NET Framework