delegate (C++/CLI и C++/CX)
Объявляет тип, представляющий указатель на функцию.
Все среды выполнения
Среда выполнения Windows, как и среда CLR, поддерживает делегаты.
Замечания
delegate — контекстно-зависимое ключевое слово. Дополнительные сведения см. в статье Context-Sensitive Keywords (C++/CLI and C++/CX) (Контекстно-зависимые ключевые слова (C++/CLI и C++/CX)).
Используйте признак типа __is_delegate() для определения во время компиляции является ли тип делегатом. Дополнительные сведения см. в статье Compiler Support for Type Traits (C++/CLI and C++/CX) (Поддержка признаков типов компилятором (C++/CLI и C++/CX)).
Среда выполнения Windows
C++/CX поддерживает делегаты со следующим синтаксисом.
Синтаксис
access
delegate
return-type
delegate-type-identifier
(
[ parameters ]
)
Параметры
access
(необязательно) Специальные возможности делегата, который может быть public (по умолчанию) или private. Прототип функции также может быть квалифицирован с помощью const ключевых слов или volatile ключевых слов.
return-type
Тип возвращаемого значения прототипа функции.
delegate-type-identifier
Имя объявленного типа делегата.
parameters
Типы и идентификаторы прототипа функции (необязательно).
Замечания
Используйте параметр delegate-type-identifier для объявления события с таким же прототипом, что и у делегата. Дополнительные сведения см. в статье Delegates (C++/CX) (Делегаты (C++/CX)).
Требования
Параметр компилятора: /ZW
Среда CLR
Среда CLR поддерживает делегаты со следующим синтаксисом.
Синтаксис
access
delegate
function_declaration
Параметры
access
Доступность делегата за пределами сборки может быть public или private (необязательно). По умолчанию — private. Внутри класса делегат может иметь любой уровень доступа.
function_declaration
Сигнатура функции, которую можно привязать к делегату. Типом возвращаемого значения делегата может быть любой управляемый тип. По соображениям взаимодействия рекомендуется, чтобы тип возвращаемого значения делегата был типом CLS.
Чтобы определить несвязанный делегат, первый параметр в function_declaration должен быть типом this указателя для объекта.
Замечания
Делегаты являются многоадресной рассылкой: "указатель функции" можно привязать к одному или нескольким методам в управляемом классе. Ключевое слово delegate определяет тип делегата многоадресной рассылки с помощью сигнатуры определенного метода.
Делегат также можно привязать к методу класса значения, такому как статический метод.
Делегат имеет следующие характеристики.
Он наследует от
System::MulticastDelegate.Он имеет конструктор, который принимает два аргумента: указатель на управляемый класс или NULL (в случае привязки к статическому методу) и полный метод указанного типа.
Он содержит метод
Invoke, сигнатура которого соответствует объявленной сигнатуре делегата.
При обращении к делегату его функции вызываются в порядке, в котором они были присоединены.
Возвращаемое значение делегата — это возвращаемое значение из его последней присоединенной функции-члена.
Делегаты не могут быть перегружены.
Делегаты можно привязать или отменить их привязку.
При создании экземпляра привязанного делегата первый аргумент должен быть ссылкой на объект. Второй аргумент созданного экземпляра делегата должен быть или адресом метода объекта управляемого класса, или указателем на метод типа значения. Второй аргумент созданного экземпляра делегата должен присвоить имя методу с помощью полного синтаксиса области класса и применить оператор address-of.
При создании экземпляра непривязанного делегата первый аргумент должен быть или адресом метода объекта управляемого класса, или указателем на метод типа значения. Аргумент должен присвоить имя методу с помощью полного синтаксиса области класса и применить оператор address-of.
При создании делегата статической или глобальной функции необходим только один параметр: функция (при необходимости адрес функции).
Дополнительные сведения о делегатах см. в следующих статьях.
Требования
Параметр компилятора: /clr
Примеры
В следующем примере показано, как объявить, инициализировать и вызвать делегаты.
// mcppv2_delegate.cpp
// compile with: /clr
using namespace System;
// declare a delegate
public delegate void MyDel(int i);
ref class A {
public:
void func1(int i) {
Console::WriteLine("in func1 {0}", i);
}
void func2(int i) {
Console::WriteLine("in func2 {0}", i);
}
static void func3(int i) {
Console::WriteLine("in static func3 {0}", i);
}
};
int main () {
A ^ a = gcnew A;
// declare a delegate instance
MyDel^ DelInst;
// test if delegate is initialized
if (DelInst)
DelInst(7);
// assigning to delegate
DelInst = gcnew MyDel(a, &A::func1);
// invoke delegate
if (DelInst)
DelInst(8);
// add a function
DelInst += gcnew MyDel(a, &A::func2);
DelInst(9);
// remove a function
DelInst -= gcnew MyDel(a, &A::func1);
// invoke delegate with Invoke
DelInst->Invoke(10);
// make delegate to static function
MyDel ^ StaticDelInst = gcnew MyDel(&A::func3);
StaticDelInst(11);
}
in func1 8
in func1 9
in func2 9
in func2 10
in static func3 11