Delegados con métodos con nombre y delegados con métodos anónimos (Guía de programación de C#)

Actualización: noviembre 2007

Se puede asociar un delegado a un método con nombre. Cuando se crean instancias de un delegado mediante un método con nombre, el método se pasa como parámetro; por ejemplo:

// Declare a delegate:
delegate void Del(int x);

// Define a named method:
void DoWork(int k) { /* ... */ }

// Instantiate the delegate using the method as a parameter:
Del d = obj.DoWork;

Esto se denomina utilizar un método con nombre. Los delegados creados con un método con nombre pueden encapsular un método estático o un método de instancia. Los métodos con nombre son la única forma de crear instancias de un delegado en versiones anteriores de C#. Sin embargo, en una situación en la que crear un método nuevo constituye una sobrecarga no deseada, C# permite crear instancias de un delegado y especificar inmediatamente un bloque de código que el delegado procesará cuando se le llame. El bloque puede contener una expresión lambda o un método anónimo. Para obtener más información, vea Funciones anónimas (Guía de programación de C#).

Comentarios

El método, que se pasa como parámetro de delegado, debe tener la misma firma que la declaración de delegado.

La instancia de un delegado puede encapsular un método estático o de instancia.

Aunque el delegado puede utilizar un parámetro out, no se recomienda su uso con delegados de eventos de multidifusión porque no se puede saber a qué delegado se va a llamar.

Ejemplo 1

El siguiente es un ejemplo sencillo de declaración y uso de un delegado. Observe que tanto el delegado, Del, como el método asociado, MultiplyNumbers, tienen la misma firma

// Declare a delegate
delegate void Del(int i, double j);

class MathClass
{
    static void Main()
    {
        MathClass m = new MathClass();

        // Delegate instantiation using "MultiplyNumbers"
        Del d = m.MultiplyNumbers;

        // Invoke the delegate object.
        System.Console.WriteLine("Invoking the delegate using 'MultiplyNumbers':");
        for (int i = 1; i <= 5; i++)
        {
            d(i, 2);
        }

        // Keep the console window open in debug mode.
        System.Console.WriteLine("Press any key to exit.");
        System.Console.ReadKey();
    }

    // Declare the associated method.
    void MultiplyNumbers(int m, double n)
    {
        System.Console.Write(m * n + " ");
    }
}
/* Output:
    Invoking the delegate using 'MultiplyNumbers':
    2 4 6 8 10
*/

Ejemplo 2

En el siguiente ejemplo, un delegado se asigna a métodos estáticos y de instancia y devuelve información específica de cada uno de ellos.

// Declare a delegate
delegate void Del();

class SampleClass
{
    public void InstanceMethod()
    {
        System.Console.WriteLine("A message from the instance method.");
    }

    static public void StaticMethod()
    {
        System.Console.WriteLine("A message from the static method.");
    }
}

class TestSampleClass
{
    static void Main()
    {
        SampleClass sc = new SampleClass();

        // Map the delegate to the instance method:
        Del d = sc.InstanceMethod;
        d();

        // Map to the static method:
        d = SampleClass.StaticMethod;
        d();
    }
}
/* Output:
    A message from the instance method.
    A message from the static method.
*/

Vea también

Tareas

Cómo: Combinar delegados (delegados de multidifusión) (Guía de programación de C#)

Conceptos

Guía de programación de C#

Referencia

Delegados (Guía de programación de C#)

Eventos (Guía de programación de C#)