Jon Jagger
Table of Contents 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 Notes DownloadECMA-334 C# Language Specificationpreviousnextprevious at this levelnext at this level 17 Classesprevious at this levelnext at this level 17.7 Eventsprevious at this levelnext at this level 17.7.2 Event accessors Paragraph 1[Note: Event declarations typically omit event-accessor-declarations, as in the Button example above. One situation for doing so involves the case in which the storage cost of one field per event is not acceptable. In such cases, a class can include event-accessor-declarations and use a private mechanism for storing the list of event handlers. Similarly, in cases where the handling of an event requires access to external resources, event accessors may be used to manage these resources. end note] Paragraph 21 The event-accessor-declarations of an event specify the executable statements associated with adding and removing event handlers. Paragraph 31 The accessor declarations consist of an add-accessor-declaration and a remove-accessor-declaration. 2 Each accessor declaration consists of the token add or remove followed by a block. 3 The block associated with an add-accessor-declaration specifies the statements to execute when an event handler is added, and the block associated with a remove-accessor-declaration specifies the statements to execute when an event handler is removed. Paragraph 41 Each add-accessor-declaration and remove-accessor-declaration corresponds to a method with a single value parameter of the event type, and a void return type. 2 The implicit parameter of an event accessor is named value. 3 When an event is used in an event assignment, the appropriate event accessor is used. 4 Specifically, if the assignment operator is += then the add accessor is used, and if the assignment operator is -= then the remove accessor is used. 5 In either case, the right-hand operand of the assignment operator is used as the argument to the event accessor. 6 The block of an add-accessor-declaration or a remove-accessor-declaration must conform to the rules for void methods described in §17.5.8. 7 In particular, return statements in such a block are not permitted to specify an expression. Paragraph 51 Since an event accessor implicitly has a parameter named value, it is a compile-time error for a local variable declared in an event accessor to have that name. [Example: In the example
class Control: Component  
   // Unique keys for events  
   static readonly object mouseDownEventKey = new object();  
   static readonly object mouseUpEventKey = new object();  
   // Return event handler associated with key  
   protected Delegate GetEventHandler(object key) {...}  
   // Add event handler associated with key  
   protected void AddEventHandler(object key, Delegate handler) {...}  
   // Remove event handler associated with key  
   protected void RemoveEventHandler(object key, Delegate handler) {...}  
   // MouseDown event  
   public event MouseEventHandler MouseDown {  
      add { AddEventHandler(mouseDownEventKey, value); }  
      remove { RemoveEventHandler(mouseDownEventKey, value); }  
   // MouseUp event  
   public event MouseEventHandler MouseUp {  
      add { AddEventHandler(mouseUpEventKey, value); }  
      remove { RemoveEventHandler(mouseUpEventKey, value); }  
   // Invoke the MouseUp event  
   protected void OnMouseUp(MouseEventArgs args) {  
      MouseEventHandler handler;   
      handler = (MouseEventHandler)GetEventHandler(mouseUpEventKey);  
      if (handler != null)  
      handler(this, args);  
the Control class implements an internal storage mechanism for events. The AddEventHandler method associates a delegate value with a key, the GetEventHandler method returns the delegate currently associated with a key, and the RemoveEventHandler method removes a delegate as an event handler for the specified event. Presumably, the underlying storage mechanism is designed such that there is no cost for associating a null delegate value with a key, and thus unhandled events consume no storage. end example]
{ JSL }
Jagger Software Ltd
Company # 4070126
VAT # 762 5213 42
Valid HTML 4.01Valid CSS