Delegate Clase

Definición

public ref class Delegate abstract

public ref class Delegate abstract : ICloneable, System::Runtime::Serialization::ISerializable

public abstract class Delegate

public abstract class Delegate : ICloneable, System.Runtime.Serialization.ISerializable

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)]
[System.Serializable]
public abstract class Delegate : ICloneable, System.Runtime.Serialization.ISerializable

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Delegate : ICloneable, System.Runtime.Serialization.ISerializable

type Delegate = class

type Delegate = class
    interface ICloneable
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)>]
[<System.Serializable>]
type Delegate = class
    interface ICloneable
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Delegate = class
    interface ICloneable
    interface ISerializable

Public MustInherit Class Delegate

Public MustInherit Class Delegate
Implements ICloneable, ISerializable

Herencia

Object

Delegate

Derivado

Microsoft.Aspnet.Snapin.DialogProc

Microsoft.Aspnet.Snapin.PropSheetPageProc

Microsoft.Extensions.Caching.Memory.PostEvictionDelegate

Microsoft.Extensions.DependencyInjection.ObjectFactory

Microsoft.Extensions.DependencyInjection.ObjectFactory<T>

Más…

Atributos

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementaciones

ICloneable ISerializable

Comentarios

La clase Delegate es la clase base para los tipos delegados. Sin embargo, solo el sistema y los compiladores pueden derivar explícitamente de la clase Delegate o de la clase MulticastDelegate. Tampoco se permite derivar un nuevo tipo de un tipo delegado. La clase Delegate no se considera un tipo de delegado; es una clase que se usa para derivar tipos de delegado.

La mayoría de los lenguajes implementan una palabra clave delegate y los compiladores para esos lenguajes pueden derivar de la clase MulticastDelegate; por lo tanto, los usuarios deben usar la palabra clave delegate proporcionada por el idioma.

Common Language Runtime proporciona cada tipo de delegado con métodos BeginInvoke y EndInvoke, para habilitar la invocación asincrónica del delegado. Para obtener más información sobre estos métodos, vea Llamar a métodos sincrónicos de forma asincrónica.

La declaración de un tipo delegado establece un contrato que especifica la firma de uno o varios métodos. Un delegado es una instancia de un tipo delegado que tiene referencias a:

• Un método de instancia de un tipo y un objeto de destino que se puede asignar a ese tipo.

• Método de instancia de un tipo, con el parámetro this oculto expuesto en la lista de parámetros formales. Se dice que el delegado es un delegado de instancia abierta.

• Un método estático.

• Un método estático y un objeto de destino asignables al primer parámetro del método. Se dice que el delegado se cierra sobre su primer argumento.

Para obtener más información sobre el enlace delegado, consulte la sobrecarga del método CreateDelegate(Type, Object, MethodInfo, Boolean).

Cuando un delegado representa un método de instancia cerrado sobre su primer argumento (el caso más común), el delegado almacena una referencia al punto de entrada del método y una referencia a un objeto, denominado destino, que es de un tipo asignable al tipo que definió el método. Cuando un delegado representa un método de instancia abierta, almacena una referencia al punto de entrada del método. La firma del delegado debe incluir el parámetro this oculto en su lista de parámetros formales; en este caso, el delegado no tiene una referencia a un objeto de destino y se debe proporcionar un objeto de destino cuando se invoca el delegado.

Cuando un delegado representa un método estático, el delegado almacena una referencia al punto de entrada del método. Cuando un delegado representa un método estático cerrado sobre su primer argumento, el delegado almacena una referencia al punto de entrada del método y una referencia a un objeto de destino asignable al tipo del primer argumento del método. Cuando se invoca el delegado, el primer argumento del método estático recibe el objeto de destino. Este primer argumento debe ser un tipo de referencia.

La lista de invocación de un delegado es un conjunto ordenado de delegados en los que cada elemento de la lista invoca exactamente uno de los métodos representados por el delegado. Una lista de invocación puede contener métodos duplicados. Durante una invocación, los métodos se invocan en el orden en que aparecen en la lista de invocación. Un delegado intenta invocar todos los métodos de su lista de invocación; los duplicados se invocan una vez por cada vez que aparecen en la lista de invocación. Los delegados son inmutables; Una vez creada, la lista de invocación de un delegado no cambia.

Los delegados se conocen como multidifusión o combinables, ya que un delegado puede invocar uno o varios métodos y se puede usar en la combinación de operaciones.

La combinación de operaciones, como Combine y Remove, no modifica los delegados existentes. En su lugar, esta operación devuelve un nuevo delegado que contiene los resultados de la operación, un delegado sin cambios o null. Una operación de combinación devuelve null cuando el resultado de la operación es un delegado que no hace referencia al menos a un método. Una operación de combinación devuelve un delegado sin cambios cuando la operación solicitada no tiene ningún efecto.

A partir de .NET Framework 4, los tipos de delegado genéricos pueden tener parámetros de tipo variant. Los parámetros de tipo contravariante se pueden usar como tipos de parámetro del delegado y se puede usar un parámetro de tipo covariante como tipo de valor devuelto. Esta característica permite que los tipos de delegado genéricos construidos a partir de la misma definición de tipo genérico sean compatibles con la asignación si sus argumentos de tipo son tipos de referencia con una relación de herencia, como se explica en Covariance y Contravariance.

Si un método invocado produce una excepción, el método deja de ejecutarse, la excepción se devuelve al autor de la llamada del delegado y no se invocan los métodos restantes de la lista de invocación. Detectar la excepción en el autor de la llamada no modifica este comportamiento.

Cuando la firma de los métodos invocados por un delegado incluye un valor devuelto, el delegado devuelve el valor devuelto del último elemento de la lista de invocación. Cuando la firma incluye un parámetro que se pasa por referencia, el valor final del parámetro es el resultado de cada método de la lista de invocación que se ejecuta secuencialmente y actualizando el valor del parámetro.

El equivalente más cercano de un delegado en C es un puntero de función. Un delegado puede representar un método estático o un método de instancia. Cuando el delegado representa un método de instancia, el delegado almacena no solo una referencia al punto de entrada del método, sino también una referencia a la instancia de clase. A diferencia de los punteros de función, los delegados están orientados a objetos y son seguros para tipos.

Para obtener ejemplos, consulte comentarios de API complementarias para System.Delegate.CreateDelegate.

Constructores

Propiedades

Métodos

Operadores

Métodos de extensión

Se aplica a

Consulte también

• MulticastDelegate
• llamar a métodos sincrónicos de forma asincrónica
• delegados (Guía de programación de C#)
• delegados de (Visual Basic)
• Cómo: Definir y usar delegados (C++/CLI)
• controlar y generar eventos