Delegate Classe

Definição

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

Herança

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>

Mais…

Atributos

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementações

ICloneable ISerializable

Comentários

A classe Delegate é a classe base para tipos delegados. No entanto, somente o sistema e os compiladores podem derivar explicitamente da classe Delegate ou da classe MulticastDelegate. Também não é permitido derivar um novo tipo de um tipo delegado. A classe Delegate não é considerada um tipo delegado; é uma classe usada para derivar tipos de delegado.

A maioria dos idiomas implementa uma palavra-chave delegate e os compiladores para esses idiomas são capazes de derivar da classe MulticastDelegate; portanto, os usuários devem usar a palavra-chave delegate fornecida pelo idioma.

O common language runtime fornece a cada tipo delegado métodos BeginInvoke e EndInvoke para habilitar a invocação assíncrona do delegado. Para obter mais informações sobre esses métodos, consulte Chamando métodos síncronos de forma assíncrona.

A declaração de um tipo delegado estabelece um contrato que especifica a assinatura de um ou mais métodos. Um delegado é uma instância de um tipo delegado que tem referências a:

• Um método de instância de um tipo e um objeto de destino atribuível a esse tipo.

• Um método de instância de um tipo, com o parâmetro this oculto exposto na lista de parâmetros formais. Diz-se que o delegado é um delegado de instância aberta.

• Um método estático.

• Um método estático e um objeto de destino atribuível ao primeiro parâmetro do método. Diz-se que o delegado foi fechado por causa de seu primeiro argumento.

Para obter mais informações sobre a associação de delegados, consulte a sobrecarga do método CreateDelegate(Type, Object, MethodInfo, Boolean).

Quando um delegado representa um método de instância fechado sobre seu primeiro argumento (o caso mais comum), o delegado armazena uma referência ao ponto de entrada do método e uma referência a um objeto, chamado de destino, que é de um tipo atribuível ao tipo que definiu o método. Quando um delegado representa um método de instância aberta, ele armazena uma referência ao ponto de entrada do método. A assinatura delegada deve incluir o parâmetro this oculto em sua lista de parâmetros formais; nesse caso, o delegado não tem uma referência a um objeto de destino e um objeto de destino deve ser fornecido quando o delegado é invocado.

Quando um delegado representa um método estático, o delegado armazena uma referência ao ponto de entrada do método. Quando um delegado representa um método estático fechado sobre seu primeiro argumento, o delegado armazena uma referência ao ponto de entrada do método e uma referência a um objeto de destino atribuível ao tipo do primeiro argumento do método. Quando o delegado é invocado, o primeiro argumento do método estático recebe o objeto de destino. Esse primeiro argumento deve ser um tipo de referência.

A lista de invocação de um delegado é um conjunto ordenado de delegados no qual cada elemento da lista invoca exatamente um dos métodos representados pelo delegado. Uma lista de invocação pode conter métodos duplicados. Durante uma invocação, os métodos são invocados na ordem em que aparecem na lista de invocação. Um delegado tenta invocar todos os métodos em sua lista de invocação; as duplicatas são invocadas uma vez para cada vez que aparecem na lista de invocação. Delegados são imutáveis; depois de criada, a lista de invocação de um delegado não é alterada.

Os delegados são chamados de multicast ou combináveis, porque um delegado pode invocar um ou mais métodos e pode ser usado na combinação de operações.

A combinação de operações, como Combine e Remove, não altera os delegados existentes. Em vez disso, tal operação retorna um novo delegado que contém os resultados da operação, um delegado inalterado ou null. Uma operação de combinação retorna null quando o resultado da operação é um delegado que não faz referência a pelo menos um método. Uma operação de combinação retorna um delegado inalterado quando a operação solicitada não tem efeito.

A partir do .NET Framework 4, os tipos de delegado genéricos podem ter parâmetros de tipo variante. Parâmetros de tipo contravariante podem ser usados como tipos de parâmetro do delegado e um parâmetro de tipo covariante pode ser usado como o tipo de retorno. Esse recurso permite que tipos delegados genéricos construídos a partir da mesma definição de tipo genérico sejam compatíveis com atribuição se seus argumentos de tipo forem tipos de referência com uma relação de herança, conforme explicado em Covariância e Contravariância.

Se um método invocado gerar uma exceção, o método interromperá a execução, a exceção será passada de volta para o chamador do delegado e os métodos restantes na lista de invocação não serão invocados. Capturar a exceção no chamador não altera esse comportamento.

Quando a assinatura dos métodos invocados por um delegado inclui um valor retornado, o delegado retorna o valor retornado do último elemento na lista de invocação. Quando a assinatura inclui um parâmetro que é passado por referência, o valor final do parâmetro é o resultado de cada método na lista de invocação sendo executado sequencialmente e atualizando o valor do parâmetro.

O equivalente mais próximo de um delegado em C é um ponteiro de função. Um delegado pode representar um método estático ou um método de instância. Quando o delegado representa um método de instância, o delegado armazena não apenas uma referência ao ponto de entrada do método, mas também uma referência à instância de classe. Ao contrário dos ponteiros de função, os delegados são orientados a objetos e digitam com segurança.

Para obter exemplos, consulte comentários da API Suplementar para System.Delegate.CreateDelegate.

Construtores

Propriedades

Métodos

Operadores

Métodos de Extensão

Aplica-se a

Confira também

• MulticastDelegate
• chamando métodos síncronos de forma assíncrona
• representantes do (Guia de Programação em C#)
• representantes do (Visual Basic)
• Como definir e usar representantes (C++/CLI)
• manipulação e geração de eventos