docs/ecma334/8.10.xml

   1 <?xml version="1.0"?>
   2 <clause number="8.10" title="Delegates" informative="true">
   3   <paragraph>Delegates enable scenarios that some other languages have addressed with function pointers. However, unlike function pointers, delegates are object-oriented and type-safe. </paragraph>
   4   <paragraph>A delegate declaration defines a class that is derived from the class System.Delegate. A delegate instance encapsulates one or more methods, each of which is referred to as a callable entity. For instance methods, a callable entity consists of an instance and a method on that instance. For static methods, a callable entity consists of just a method. Given a delegate instance and an appropriate set of arguments, one can invoke all of that delegate instance's methods with that set of arguments. </paragraph>
   5   <paragraph>An interesting and useful property of a delegate instance is that it does not know or care about the classes of the methods it encapsulates; all that matters is that those methods be compatible (<hyperlink>22.1</hyperlink>) with the delegate's type. This makes delegates perfectly suited for &quot;anonymous&quot; invocation. This is a powerful capability. </paragraph>
   6   <paragraph>There are three steps in defining and using delegates: declaration, instantiation, and invocation. Delegates are declared using delegate declaration syntax. The example <code_example><![CDATA[
   7 delegate void SimpleDelegate();
   8 ]]></code_example>declares a delegate named SimpleDelegate that takes no arguments and returns no result. </paragraph>
   9   <paragraph>The example <code_example><![CDATA[
  10 class Test
  11 {
  12    static void F() {
  13       System.Console.WriteLine("Test.F");
  14    }
  15    static void Main() {
  16       SimpleDelegate d = new SimpleDelegate(F);
  17       d();
  18    }
  19 }
  20 ]]></code_example>creates a SimpleDelegate instance and then immediately calls it. </paragraph>
  21   <paragraph>There is not much point in instantiating a delegate for a method and then immediately calling that method via the delegate, as it would be simpler to call the method directly. Delegates really show their usefulness when their anonymity is used. The example <code_example><![CDATA[
  22 void MultiCall(SimpleDelegate d, int count) {
  23    for (int i = 0; i < count; i++) {
  24       d();
  25    }
  26 }
  27 ]]></code_example>shows a MultiCall method that repeatedly calls a SimpleDelegate. The MultiCall method doesn't know or care about the type of the target method for the SimpleDelegate, what accessibility that method has, or whether or not that method is static. All that matters is that the target method is compatible (<hyperlink>22.1</hyperlink>) with SimpleDelegate. </paragraph>
  28 </clause>