Delegate Classe

Definizione

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

Ereditarietà

Object

Delegate

Derivato

Microsoft.Aspnet.Snapin.DialogProc

Microsoft.Aspnet.Snapin.PropSheetPageProc

Microsoft.Extensions.Caching.Memory.PostEvictionDelegate

Microsoft.Extensions.DependencyInjection.ObjectFactory

Microsoft.Extensions.DependencyInjection.ObjectFactory<T>

Altro…

Attributi

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementazioni

ICloneable ISerializable

Commenti

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

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

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

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 metodo CreateDelegate(Type, Object, MethodInfo, Boolean).

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 this nascosto nell'elenco dei parametri formali; in questo caso, il delegato non dispone di un riferimento a un oggetto di destinazione e un oggetto di destinazione deve essere fornito 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.

A partire da .NET Framework 4, 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 supplementari dell'API per System.Delegate.CreateDelegate.

Costruttori

Proprietà

Metodi

Operatori

Metodi di estensione

Si applica a

Vedi anche

• MulticastDelegate
• chiamare metodi sincroni in modo asincrono
• delegati (Guida per programmatori C#)
• delegati (Visual Basic)
• Procedura: Definire e usare delegati (C++/CLI)
• gestione e generazione di eventi