Utilizzo della varianza nei delegati (C# e Visual Basic)

Quando si assegna un metodo a un delegato, covarianza e controvarianza forniscono la flessibilità per la corrispondenza di un tipo delegato con una firma del metodo. La covarianza consente a un metodo di avere un tipo restituito più derivato di quello definito nel delegato. La controvarianza consente un metodo che dispone tipi di parametri meno derivati di quelli del tipo delegato.

Esempio 1: covarianza

Oggetto di descrizione

Nell'esempio seguente viene illustrato come utilizzare i delegati con metodi che hanno tipi restituiti derivati dal tipo restituito nella firma del delegato. Il tipo di dati restituito da DogsHandler è di tipo Dogs, che deriva dal tipo Mammals definito nel delegato.

Codice

Class Mammals
End Class

Class Dogs
    Inherits Mammals
End Class
Class Test
    Public Delegate Function HandlerMethod() As Mammals
    Public Shared Function MammalsHandler() As Mammals
        Return Nothing
    End Function
    Public Shared Function DogsHandler() As Dogs
        Return Nothing
    End Function
    Sub Test()
        Dim handlerMammals As HandlerMethod = AddressOf MammalsHandler
        ' Covariance enables this assignment.
        Dim handlerDogs As HandlerMethod = AddressOf DogsHandler
    End Sub
End Class

class Mammals{}
class Dogs : Mammals{}

class Program
{
    // Define the delegate.
    public delegate Mammals HandlerMethod();

    public static Mammals MammalsHandler()
    {
        return null;
    }

    public static Dogs DogsHandler()
    {
        return null;
    }

    static void Test()
    {
        HandlerMethod handlerMammals = MammalsHandler;

        // Covariance enables this assignment.
        HandlerMethod handlerDogs = DogsHandler;
    }
}

Esempio 2: controvarianza

Oggetto di descrizione

Nell'esempio seguente viene illustrato come utilizzare i delegati con metodi che hanno parametri di un tipo che è tipo base del tipo di parametro della firma del delegato. Con la controvarianza, è possibile utilizzare un gestore di eventi anziché gestori separati. È possibile ad esempio creare un gestore eventi che accetti un parametro di input EventArgs e utilizzarlo con l'evento Button.MouseClick che invia un tipo MouseEventArgs come parametro e con l'evento TextBox.KeyDown che invia un parametro KeyEventArgs.

Codice

' Event hander that accepts a parameter of the EventArgs type.
Private Sub MultiHandler(ByVal sender As Object,
                         ByVal e As System.EventArgs)
    Label1.Text = DateTime.Now
End Sub

Private Sub Form1_Load(ByVal sender As System.Object,
    ByVal e As System.EventArgs) Handles MyBase.Load

    ' You can use a method that has an EventArgs parameter,
    ' although the event expects the KeyEventArgs parameter.
    AddHandler Button1.KeyDown, AddressOf MultiHandler

    ' You can use the same method 
    ' for the event that expects the MouseEventArgs parameter.
    AddHandler Button1.MouseClick, AddressOf MultiHandler
End Sub

// Event hander that accepts a parameter of the EventArgs type.
private void MultiHandler(object sender, System.EventArgs e)
{
    label1.Text = System.DateTime.Now.ToString();
}

public Form1()
{
    InitializeComponent();

    // You can use a method that has an EventArgs parameter,
    // although the event expects the KeyEventArgs parameter.
    this.button1.KeyDown += this.MultiHandler;

    // You can use the same method 
    // for an event that expects the MouseEventArgs parameter.
    this.button1.MouseClick += this.MultiHandler;

}

Vedere anche

Riferimenti

Utilizzo della varianza per i delegati generici Func e Action (C# e Visual Basic)

Concetti

Varianza nei delegati (C# e Visual Basic)