Delegate Klas

Definitie

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

Overname

Object

Delegate

Afgeleid

Microsoft.Aspnet.Snapin.DialogProc

Microsoft.Aspnet.Snapin.PropSheetPageProc

Microsoft.VisualBasic.ApplicationServices.ShutdownEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupEventHandler

Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler

Meer…

Kenmerken

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementeringen

ICloneable ISerializable

Opmerkingen

De Delegate klasse is de basisklasse voor gemachtigde typen. Alleen het systeem en de compilers kunnen echter expliciet worden afgeleid van de Delegate klasse of van de MulticastDelegate klasse. Het is ook niet toegestaan om een nieuw type af te leiden van een gemachtigde. De klasse wordt niet beschouwd als een gemachtigdentype. Het Delegate is een klasse die wordt gebruikt om gedelegeerdentypen af te leiden.

De meeste talen implementeren een delegate trefwoord en compilers voor deze talen kunnen worden afgeleid van de MulticastDelegate klasse. Daarom moeten gebruikers het delegate trefwoord gebruiken dat door de taal wordt geleverd.

De algemene taalruntime biedt elk type gedelegeerde met BeginInvoke en EndInvoke methoden om asynchrone aanroep van de gemachtigde in te schakelen. Zie Synchrone methoden asynchroon aanroepen voor meer informatie over deze methoden.

Met de declaratie van een gemachtigdentype wordt een contract gemaakt dat de handtekening van een of meer methoden aangeeft. Een gemachtigde is een instantie van een gemachtigde die verwijst naar:

• Een exemplaarmethode van een type en een doelobject dat aan dat type kan worden toegewezen.
• Een exemplaarmethode van een type, waarbij de verborgen this parameter wordt weergegeven in de formele parameterlijst. De gemachtigde wordt gezegd een gemachtigde van het open exemplaar te zijn.
• Een statische methode.
• Een statische methode en een doelobject dat kan worden toegewezen aan de eerste parameter van de methode. De gemachtigde wordt gezegd dat deze wordt gesloten over het eerste argument.

Zie de overbelasting van de CreateDelegate(Type, Object, MethodInfo, Boolean) methode voor meer informatie over gedelegeerde binding.

Wanneer een gemachtigde een instantiemethode vertegenwoordigt die is gesloten over het eerste argument (het meest voorkomende geval), slaat de gedelegeerde een verwijzing op naar het ingangspunt van de methode en een verwijzing naar een object, het doel genoemd. Dit is een type dat kan worden toegewezen aan het type dat de methode heeft gedefinieerd. Wanneer een gemachtigde een open exemplaarmethode vertegenwoordigt, wordt een verwijzing naar het toegangspunt van de methode opgeslagen. De handtekening van de gemachtigde moet de verborgen this parameter bevatten in de formele parameterlijst. In dit geval heeft de gedelegeerde geen verwijzing naar een doelobject en moet een doelobject worden opgegeven wanneer de gemachtigde wordt aangeroepen.

Wanneer een gemachtigde een statische methode vertegenwoordigt, slaat de gedelegeerde een verwijzing op naar het toegangspunt van de methode. Wanneer een gemachtigde een statische methode vertegenwoordigt die is gesloten over het eerste argument, slaat de gedelegeerde een verwijzing op naar het toegangspunt van de methode en een verwijzing naar een doelobject dat kan worden toegewezen aan het type van het eerste argument van de methode. Wanneer de gemachtigde wordt aangeroepen, ontvangt het eerste argument van de statische methode het doelobject. Dit eerste argument moet een verwijzingstype zijn.

De aanroeplijst van een gemachtigde is een geordende set gedelegeerden waarin elk element van de lijst precies een van de methoden aanroept die door de gemachtigde worden vertegenwoordigd. Een aanroeplijst kan dubbele methoden bevatten. Tijdens een aanroep worden methoden aangeroepen in de volgorde waarin ze worden weergegeven in de aanroeplijst. Een gemachtigde probeert elke methode in de aanroeplijst aan te roepen; duplicaten worden eenmaal aangeroepen voor elke keer dat ze worden weergegeven in de aanroeplijst. Gemachtigden zijn onveranderbaar; zodra deze is gemaakt, verandert de aanroeplijst van een gemachtigde niet.

Gemachtigden worden multicast of combinatiebaar genoemd, omdat een gemachtigde een of meer methoden kan aanroepen en kan worden gebruikt bij het combineren van bewerkingen.

Het combineren van bewerkingen, zoals Combine en Remove, wijzigen bestaande gemachtigden niet. In plaats daarvan retourneert een dergelijke bewerking een nieuwe gemachtigde die de resultaten van de bewerking, een ongewijzigde gemachtigde of null. Een combinatiebewerking wordt geretourneerd null wanneer het resultaat van de bewerking een gemachtigde is die niet naar ten minste één methode verwijst. Een combinatiebewerking retourneert een ongewijzigde gemachtigde wanneer de aangevraagde bewerking geen effect heeft.

Algemene gemachtigdentypen kunnen varianttypeparameters hebben. Contravarianttypeparameters kunnen worden gebruikt als parametertypen van de gemachtigde en een covarianttypeparameter kan worden gebruikt als het retourtype. Met deze functie kunnen algemene gedelegeerde typen die zijn samengesteld op basis van dezelfde algemene typedefinitie compatibel zijn als hun typeargumenten verwijzingstypen zijn met een overnamerelatie, zoals wordt uitgelegd in Covariantie en Contravariantie.

Als een aangeroepen methode een uitzondering genereert, wordt de methode gestopt met uitvoeren, wordt de uitzondering teruggegeven aan de aanroeper van de gemachtigde en worden de resterende methoden in de aanroeplijst niet aangeroepen. Als u de uitzondering in de aanroeper ondervangt, verandert dit gedrag niet.

Wanneer de handtekening van de methoden die door een gemachtigde worden aangeroepen een retourwaarde bevat, retourneert de gedelegeerde de retourwaarde van het laatste element in de aanroeplijst. Wanneer de handtekening een parameter bevat die doorverwijzing wordt doorgegeven, is de uiteindelijke waarde van de parameter het resultaat van elke methode in de aanroeplijst die opeenvolgend wordt uitgevoerd en de waarde van de parameter wordt bijgewerkt.

Het dichtstbijzijnde equivalent van een gemachtigde in C is een functiepointer. Een gemachtigde kan een statische methode of een instantiemethode vertegenwoordigen. Wanneer de gemachtigde een instantiemethode vertegenwoordigt, slaat de gedelegeerde niet alleen een verwijzing op naar het toegangspunt van de methode, maar ook naar het klasse-exemplaar. In tegenstelling tot functiepointers zijn gemachtigden objectgeoriënteerd en typen ze veilig.

Zie aanvullende API-opmerkingen voor System.Delegate.CreateDelegate voor voorbeelden.

Zie ook

• MulticastDelegate
• Het asynchroon aanroepen van synchrone methoden
• Gemachtigden (C#-programmeerhandleiding)
• Delegates (Visual Basic)
• Procedure: Gemachtigden definiëren en gebruiken (C++/CLI)
• Gebeurtenissen afhandelen en verhogen