Delegate Classe

Definição

public ref class Delegate abstract

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

public abstract class Delegate

[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

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

type Delegate = class

[<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

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.VisualBasic.ApplicationServices.ShutdownEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler

Mais…

Atributos

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementações

ICloneable ISerializable

Observações

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

A maioria das linguagens implementa uma delegate palavra-chave, e os compiladores dessas linguagens conseguem derivar da MulticastDelegate classe; por isso, os utilizadores devem usar a delegate palavra-chave fornecida pela língua.

O runtime da linguagem comum fornece a cada tipo de delegado e BeginInvokeEndInvoke métodos, permitindo a invocação assíncrona do delegado. Para mais informações sobre estes métodos, veja Chamar Métodos Síncronos Assíncronos.

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

• Um método de instância de um tipo e um objeto alvo atribuível a esse tipo.
• Um método de instância de um tipo, com o parâmetro oculto this exposto na lista formal de parâmetros. Diz-se que o delegado é um delegado de instância aberta.
• Um método estático.
• Um método estático e um objeto alvo atribuível ao primeiro parâmetro do método. Diz-se que o delegado está fechado quanto ao seu primeiro argumento.

Para mais informações sobre a ligação de delegados, veja a CreateDelegate(Type, Object, MethodInfo, Boolean) sobrecarga de métodos.

Quando um delegado representa um método de instância fechado sobre o 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 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, armazena uma referência ao ponto de entrada do método. A assinatura do delegado deve incluir o parâmetro oculto this na sua lista formal de parâmetros; neste caso, o delegado não tem referência a um objeto alvo, e um objeto alvo 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 o seu primeiro argumento, o delegado armazena uma referência ao ponto de entrada do método e uma referência a um objeto alvo 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 alvo. Este primeiro argumento deve ser um tipo de referência.

A lista de invocação de um delegado é um conjunto ordenado de delegados em que cada elemento da lista invoca exatamente um dos métodos representados pelo delegado. Uma lista de invocações pode conter métodos duplicados. Durante uma invocação, os métodos são invocados pela ordem em que aparecem na lista de invocações. Um delegado tenta invocar todos os métodos da sua lista de invocações; Os duplicados são invocados uma vez por cada vez que aparecem na lista de invocações. Os delegados são imutáveis; Uma vez criada, a lista de invocações de um delegado não muda.

Os delegados são designados por multicast, ou combináveis, porque um delegado pode invocar um ou mais métodos e podem ser usados em operações de combinação.

Operações de combinação, como Combine e Remove, não alteram os delegados existentes. Em vez disso, tal operação devolve 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 devolve um delegado inalterado quando a operação solicitada não tem efeito.

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

Se um método invocado lançar uma exceção, o método deixa de ser executado, a exceção é passada de volta ao chamador do delegado, e os métodos restantes na lista de invocação não são invocados. Apanhar a exceção no chamador não altera este comportamento.

Quando a assinatura dos métodos invocados por um delegado inclui um valor de retorno, o delegado devolve o valor de retorno 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ções a executar-se sequencialmente e a atualizar 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 só uma referência ao ponto de entrada do método, mas também uma referência à instância da classe. Ao contrário dos ponteiros de função, os delegados são orientados a objetos e seguros para tipos.

Para exemplos, veja Observações suplementares da API para System.Delegate.CreateDelegate.

Ver também

• MulticastDelegate
• Chamando métodos síncronos de forma assíncrona
• Delegados (Guia de Programação em C#)
• Delegados (Visual Basic)
• Como definir e usar delegados (C++/CLI)
• Manuseamento e Criação de Eventos