Cómo: Definir y utilizar delegados (C++/CLI)

Artículo
04/03/2023

En este artículo se muestra cómo definir y consumir delegados en C++/CLI.

Aunque .NET Framework proporciona una serie de delegados, a veces es posible que tenga que definir delegados nuevos.

En el ejemplo de código siguiente se define un delegado denominado MyCallback. El código de control de eventos (la función a la que se llama cuando se desencadena este delegado nuevo), debe tener un tipo de valor devuelto de void y tomar una referencia String.

La función principal usa un método estático que lo define SomeClass para crear una instancia del delegado MyCallback. Después, el delegado se convierte en un método alternativo al de llamar a esta función, tal como se demuestra enviando la cadena "single" al objeto delegado. A continuación, las instancias adicionales de MyCallback se vinculan juntas y, después, se ejecutan mediante una llamada al objeto delegado.

// use_delegate.cpp
// compile with: /clr
using namespace System;

ref class SomeClass
{
public:
   static void Func(String^ str)
   {
      Console::WriteLine("static SomeClass::Func - {0}", str);
   }
};

ref class OtherClass
{
public:
   OtherClass( Int32 n )
   {
      num = n;
   }

   void Method(String^ str)
   {
      Console::WriteLine("OtherClass::Method - {0}, num = {1}",
         str, num);
   }

   Int32 num;
};

delegate void MyCallback(String^ str);

int main( )
{
   MyCallback^ callback = gcnew MyCallback(SomeClass::Func);
   callback("single");

   callback += gcnew MyCallback(SomeClass::Func);

   OtherClass^ f = gcnew OtherClass(99);
   callback += gcnew MyCallback(f, &OtherClass::Method);

   f = gcnew OtherClass(100);
   callback += gcnew MyCallback(f, &OtherClass::Method);

   callback("chained");

   return 0;
}

static SomeClass::Func - single
static SomeClass::Func - chained
static SomeClass::Func - chained
OtherClass::Method - chained, num = 99
OtherClass::Method - chained, num = 100

En el ejemplo de código siguiente se muestra cómo asociar un delegado a un miembro de una clase de valor.

// mcppv2_del_mem_value_class.cpp
// compile with: /clr
using namespace System;
public delegate void MyDel();

value class A {
public:
   void func1() {
      Console::WriteLine("test");
   }
};

int main() {
   A a;
   A^ ah = a;
   MyDel^ f = gcnew MyDel(a, &A::func1);   // implicit box of a
   f();
   MyDel^ f2 = gcnew MyDel(ah, &A::func1);
   f2();
}

test
test

Procedimientos para crear delegados

Puede usar el operador "-" para quitar un delegado de componente de un delegado compuesto.

// mcppv2_compose_delegates.cpp
// compile with: /clr
using namespace System;

delegate void MyDelegate(String ^ s);

ref class MyClass {
public:
   static void Hello(String ^ s) {
      Console::WriteLine("Hello, {0}!", s);
   }

   static void Goodbye(String ^ s) {
      Console::WriteLine("  Goodbye, {0}!", s);
   }
};

int main() {

   MyDelegate ^ a = gcnew MyDelegate(MyClass::Hello);
   MyDelegate ^ b = gcnew MyDelegate(MyClass::Goodbye);
   MyDelegate ^ c = a + b;
   MyDelegate ^ d = c - a;

   Console::WriteLine("Invoking delegate a:");
   a("A");
   Console::WriteLine("Invoking delegate b:");
   b("B");
   Console::WriteLine("Invoking delegate c:");
   c("C");
   Console::WriteLine("Invoking delegate d:");
   d("D");
}

Salida

Invoking delegate a:
Hello, A!
Invoking delegate b:
  Goodbye, B!
Invoking delegate c:
Hello, C!
  Goodbye, C!
Invoking delegate d:
  Goodbye, D!

Paso de un delegado^ a una función nativa que espera un puntero de función

Desde un componente administrado, puede llamar a una función nativa con parámetros de puntero de función en la que la función nativa puede llamar a la función miembro del delegado del componente administrado.

En este ejemplo se crea el archivo .dll que exporta la función nativa:

// delegate_to_native_function.cpp
// compile with: /LD
#include < windows.h >
extern "C" {
   __declspec(dllexport)
   void nativeFunction(void (CALLBACK *mgdFunc)(const char* str)) {
      mgdFunc("Call to Managed Function");
   }
}

El ejemplo siguiente consume el archivo .dll y pasa un identificador de delegado a la función nativa que espera un puntero de función.

// delegate_to_native_function_2.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;

delegate void Del(String ^s);
public ref class A {
public:
   void delMember(String ^s) {
      Console::WriteLine(s);
   }
};

[DllImportAttribute("delegate_to_native_function", CharSet=CharSet::Ansi)]
extern "C" void nativeFunction(Del ^d);

int main() {
   A ^a = gcnew A;
   Del ^d = gcnew Del(a, &A::delMember);
   nativeFunction(d);   // Call to native function
}

Salida

Call to Managed Function

Asociación de delegados a funciones no administradas

Para asociar un delegado a una función nativa, debe encapsular esta función en un tipo administrado y declarar la función que se va a invocar mediante PInvoke.

// mcppv2_del_to_umnangd_func.cpp
// compile with: /clr
#pragma unmanaged
extern "C" void printf(const char*, ...);
class A {
public:
   static void func(char* s) {
      printf(s);
   }
};

#pragma managed
public delegate void func(char*);

ref class B {
   A* ap;

public:
   B(A* ap):ap(ap) {}
   void func(char* s) {
      ap->func(s);
   }
};

int main() {
   A* a = new A;
   B^ b = gcnew B(a);
   func^ f = gcnew func(b, &B::func);
   f("hello");
   delete a;
}

Salida

hello

Uso de delegados sin enlazar

Puede usar un delegado sin enlazar para pasar una instancia del tipo a cuya función quiere llamar cuando se llama al delegado.

Los delegados no enlazados son especialmente útiles si quiere recorrer en iteración los objetos de una colección (mediante las palabras clave for each, in palabras clave) y llamar a una función miembro en cada instancia.

Aquí se muestra cómo declarar, crear instancias y llamar a delegados enlazados y sin enlazar:

Acción	Delegados enlazados	Delegados sin enlazar
Declare	La signatura del delegado debe coincidir con la signatura de la función a la que quiere llamar mediante el delegado.	El primer parámetro de la signatura del delegado es el tipo de `this` para el objeto al que quiere llamar. Después del primer parámetro, la signatura del delegado debe coincidir con la signatura de la función a la que quiere llamar mediante el delegado.
Crea una instancia	Al crear una instancia de un delegado enlazado, puede especificar una función de instancia o una función miembro global o estática. Para especificar una función de instancia, el primer parámetro es una instancia del tipo a cuya función miembro quiere llamar y, el segundo, es la dirección de la función a la que quiere llamar. Si quiere llamar a una función miembro global o estática, tan solo tiene que pasar el nombre de una función global o el nombre de la función miembro estática.	Al crear una instancia de un delegado sin enlazar, simplemente pase la dirección de la función a la que quiere llamar.
Call	Cuando llama a un delegado enlazado, basta con pasar los parámetros que requiere la signatura del delegado.	Igual que en un delegado enlazado, pero recuerde que el primer parámetro debe ser una instancia del objeto que contiene la función a la que quiere llamar.

En este ejemplo se muestra cómo declarar delegados sin enlazar, crear instancias de estos y llamar a ellos:

// unbound_delegates.cpp
// compile with: /clr
ref struct A {
   A(){}
   A(int i) : m_i(i) {}
   void Print(int i) { System::Console::WriteLine(m_i + i);}

private:
   int m_i;
};

value struct V {
   void Print() { System::Console::WriteLine(m_i);}
   int m_i;
};

delegate void Delegate1(A^, int i);
delegate void Delegate2(A%, int i);

delegate void Delegate3(interior_ptr<V>);
delegate void Delegate4(V%);

delegate void Delegate5(int i);
delegate void Delegate6();

int main() {
   A^ a1 = gcnew A(1);
   A% a2 = *gcnew A(2);

   Delegate1 ^ Unbound_Delegate1 = gcnew Delegate1(&A::Print);
   // delegate takes a handle
   Unbound_Delegate1(a1, 1);
   Unbound_Delegate1(%a2, 1);

   Delegate2 ^ Unbound_Delegate2 = gcnew Delegate2(&A::Print);
   // delegate takes a tracking reference (must deference the handle)
   Unbound_Delegate2(*a1, 1);
   Unbound_Delegate2(a2, 1);

   // instantiate a bound delegate to an instance member function
   Delegate5 ^ Bound_Del = gcnew Delegate5(a1, &A::Print);
   Bound_Del(1);

   // instantiate value types
   V v1 = {7};
   V v2 = {8};

   Delegate3 ^ Unbound_Delegate3 = gcnew Delegate3(&V::Print);
   Unbound_Delegate3(&v1);
   Unbound_Delegate3(&v2);

   Delegate4 ^ Unbound_Delegate4 = gcnew Delegate4(&V::Print);
   Unbound_Delegate4(v1);
   Unbound_Delegate4(v2);

   Delegate6 ^ Bound_Delegate3 = gcnew Delegate6(v1, &V::Print);
   Bound_Delegate3();
}

Salida

En el ejemplo siguiente se muestra cómo usar delegados sin enlazar y las palabras clave for each, in para recorrer en iteración los objetos de una colección y llamar a una función miembro en cada instancia.

// unbound_delegates_2.cpp
// compile with: /clr
using namespace System;

ref class RefClass {
   String^ _Str;

public:
   RefClass( String^ str ) : _Str( str ) {}
   void Print() { Console::Write( _Str ); }
};

delegate void PrintDelegate( RefClass^ );

int main() {
   PrintDelegate^ d = gcnew PrintDelegate( &RefClass::Print );

   array< RefClass^ >^ a = gcnew array<RefClass^>( 10 );

   for ( int i = 0; i < a->Length; ++i )
      a[i] = gcnew RefClass( i.ToString() );

   for each ( RefClass^ R in a )
      d( R );

   Console::WriteLine();
}

En este ejemplo se crea un delegado sin enlazar en las funciones de descriptor de acceso de una propiedad:

// unbound_delegates_3.cpp
// compile with: /clr
ref struct B {
   property int P1 {
      int get() { return m_i; }
      void set(int i) { m_i = i; }
   }

private:
   int m_i;
};

delegate void DelBSet(B^, int);
delegate int DelBGet(B^);

int main() {
   B^ b = gcnew B;

   DelBSet^ delBSet = gcnew DelBSet(&B::P1::set);
   delBSet(b, 11);

   DelBGet^ delBGet = gcnew DelBGet(&B::P1::get);
   System::Console::WriteLine(delBGet(b));
}

Salida

En el ejemplo siguiente se muestra cómo invocar un delegado de multidifusión, en el que una instancia está enlazada y una instancia está sin enlazar.

// unbound_delegates_4.cpp
// compile with: /clr
ref class R {
public:
   R(int i) : m_i(i) {}

   void f(R ^ r) {
      System::Console::WriteLine("in f(R ^ r)");
   }

   void f() {
      System::Console::WriteLine("in f()");
   }

private:
   int m_i;
};

delegate void Del(R ^);

int main() {
   R ^r1 = gcnew R(11);
   R ^r2 = gcnew R(12);

   Del^ d = gcnew Del(r1, &R::f);
   d += gcnew Del(&R::f);
   d(r2);
};

Salida

in f(R ^ r)
in f()

En el ejemplo siguiente se muestra cómo crear un delegado genérico sin enlazar y llamar a este.

// unbound_delegates_5.cpp
// compile with: /clr
ref struct R {
   R(int i) : m_i(i) {}

   int f(R ^) { return 999; }
   int f() { return m_i + 5; }

   int m_i;
};

value struct V {
   int f(V%) { return 999; }
   int f() { return m_i + 5; }

   int m_i;
};

generic <typename T>
delegate int Del(T t);

generic <typename T>
delegate int DelV(T% t);

int main() {
   R^ hr = gcnew R(7);
   System::Console::WriteLine((gcnew Del<R^>(&R::f))(hr));

   V v;
   v.m_i = 9;
   System::Console::WriteLine((gcnew DelV<V >(&V::f))(v) );
}

Salida

12
14

Consulte también

delegate (Extensiones de componentes de C++)

Cómo: Definir y utilizar delegados (C++/CLI)

Procedimientos para crear delegados

Paso de un delegado^ a una función nativa que espera un puntero de función

Asociación de delegados a funciones no administradas

Uso de delegados sin enlazar

Consulte también

Comentarios

Comentarios

Recursos adicionales