Delegate Classe

Definizione

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

Ereditarietà

Object

Delegate

Derivato

Microsoft.Aspnet.Snapin.DialogProc

Microsoft.Aspnet.Snapin.PropSheetPageProc

Microsoft.VisualBasic.ApplicationServices.ShutdownEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler

Altro…

Attributi

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementazioni

ICloneable ISerializable

Commenti

La Delegate classe è la classe base per i tipi delegati. Tuttavia, solo il sistema e i compilatori possono derivare in modo esplicito dalla Delegate classe o dalla MulticastDelegate classe . Non è inoltre consentito derivare un nuovo tipo da un tipo delegato. La Delegate classe non è considerata un tipo delegato. Si tratta di una classe usata per derivare i tipi delegati.

La maggior parte dei linguaggi implementa una delegate parola chiave e i compilatori per tali linguaggi sono in grado di derivare dalla MulticastDelegate classe. Pertanto, gli utenti devono usare la delegate parola chiave fornita dal linguaggio.

Common Language Runtime fornisce a ogni tipo delegato BeginInvoke metodi e EndInvoke per abilitare la chiamata asincrona del delegato. Per altre informazioni su questi metodi, vedere Chiamata asincrona di metodi sincroni.

La dichiarazione di un tipo delegato stabilisce un contratto che specifica la firma di uno o più metodi. Un delegato è un'istanza di un tipo delegato con riferimenti a:

• Metodo di istanza di un tipo e un oggetto di destinazione assegnabile a tale tipo.
• Metodo di istanza di un tipo, con il parametro nascosto this esposto nell'elenco di parametri formali. Si dice che il delegato sia un delegato di istanza aperto.
• Metodo statico.
• Metodo statico e oggetto di destinazione assegnabile al primo parametro del metodo . Si dice che il delegato venga chiuso sul primo argomento.

Per altre informazioni sull'associazione di delegati, vedere l'overload del CreateDelegate(Type, Object, MethodInfo, Boolean) metodo.

Quando un delegato rappresenta un metodo di istanza chiuso sul primo argomento (il caso più comune), il delegato archivia un riferimento al punto di ingresso del metodo e un riferimento a un oggetto, denominato destinazione, che è di un tipo assegnabile al tipo che ha definito il metodo. Quando un delegato rappresenta un metodo di istanza aperto, archivia un riferimento al punto di ingresso del metodo. La firma del delegato deve includere il parametro nascosto this nell'elenco dei parametri formali. In questo caso, il delegato non dispone di un riferimento a un oggetto di destinazione e deve essere fornito un oggetto di destinazione quando viene richiamato il delegato.

Quando un delegato rappresenta un metodo statico, il delegato archivia un riferimento al punto di ingresso del metodo. Quando un delegato rappresenta un metodo statico chiuso sul primo argomento, il delegato archivia un riferimento al punto di ingresso del metodo e un riferimento a un oggetto di destinazione assegnabile al tipo del primo argomento del metodo. Quando il delegato viene richiamato, il primo argomento del metodo statico riceve l'oggetto di destinazione. Questo primo argomento deve essere un tipo riferimento.

L'elenco chiamate di un delegato è un set ordinato di delegati in cui ogni elemento dell'elenco richiama esattamente uno dei metodi rappresentati dal delegato. Un elenco chiamate può contenere metodi duplicati. Durante una chiamata, i metodi vengono richiamati nell'ordine in cui vengono visualizzati nell'elenco chiamate. Un delegato tenta di richiamare ogni metodo nell'elenco chiamate; i duplicati vengono richiamati una volta per ogni volta che vengono visualizzati nell'elenco chiamate. I delegati non sono modificabili; una volta creato, l'elenco chiamate di un delegato non cambia.

I delegati vengono definiti multicast o combinabili, perché un delegato può richiamare uno o più metodi e può essere usato nella combinazione di operazioni.

La combinazione di operazioni, ad esempio Combine e Remove, non modifica i delegati esistenti. In alternativa, tale operazione restituisce un nuovo delegato che contiene i risultati dell'operazione, un delegato non modificato o null. Un'operazione di combinazione restituisce null quando il risultato dell'operazione è un delegato che non fa riferimento ad almeno un metodo. Un'operazione di combinazione restituisce un delegato invariato quando l'operazione richiesta non ha alcun effetto.

I tipi delegati generici possono avere parametri di tipo varianti. I parametri di tipo controvariante possono essere usati come tipi di parametro del delegato e un parametro di tipo covariante può essere usato come tipo restituito. Questa funzionalità consente ai tipi delegati generici costruiti dalla stessa definizione di tipo generico di essere compatibili con l'assegnazione se i relativi argomenti di tipo sono tipi di riferimento con una relazione di ereditarietà, come illustrato in Covarianza e Controvarianza.

Se un metodo richiamato genera un'eccezione, il metodo interrompe l'esecuzione, l'eccezione viene passata al chiamante del delegato e i metodi rimanenti nell'elenco chiamate non vengono richiamati. L'intercettazione dell'eccezione nel chiamante non modifica questo comportamento.

Quando la firma dei metodi richiamati da un delegato include un valore restituito, il delegato restituisce il valore restituito dell'ultimo elemento nell'elenco chiamate. Quando la firma include un parametro passato per riferimento, il valore finale del parametro è il risultato di ogni metodo nell'elenco chiamate eseguito in sequenza e aggiornando il valore del parametro.

L'equivalente più vicino di un delegato in C è un puntatore a funzione. Un delegato può rappresentare un metodo statico o un metodo di istanza. Quando il delegato rappresenta un metodo di istanza, il delegato archivia non solo un riferimento al punto di ingresso del metodo, ma anche un riferimento all'istanza della classe. A differenza dei puntatori a funzione, i delegati sono orientati agli oggetti e indipendenti dai tipi.

Per esempi, vedere Osservazioni aggiuntive sulle API per System.Delegate.CreateDelegate.

Vedi anche

• MulticastDelegate
• Chiamare metodi sincroni in modalità asincrona
• Delegati (Guida per programmatori C#)
• Delegates (Visual Basic)
• Procedura: Definire e usare delegati (C++/CLI)
• Gestione e generazione di eventi