mcs/docs/ecma334/17.5.6.xml

   1 <?xml version="1.0"?>
   2 <clause number="17.5.6" title="Abstract methods">
   3   <paragraph>When an instance method declaration includes an abstract modifier, that method is said to be an abstract method. Although an abstract method is implicitly also a virtual method, it cannot have the modifier virtual. </paragraph>
   4   <paragraph>An abstract method declaration introduces a new virtual method but does not provide an implementation of that method. Instead, non-abstract derived classes are required to provide their own implementation by overriding that method. Because an abstract method provides no actual implementation, the <non_terminal where="17.5">method-body</non_terminal> of an abstract method simply consists of a semicolon. </paragraph>
   5   <paragraph>Abstract method declarations are only permitted in abstract classes (<hyperlink>17.1.1.1</hyperlink>). </paragraph>
   6   <paragraph>
   7     <example>[Example: In the example <code_example><![CDATA[
   8 public abstract class Shape
   9 {
  10    public abstract void Paint(Graphics g, Rectangle r);
  11 }
  12 public class Ellipse: Shape
  13 {
  14    public override void Paint(Graphics g, Rectangle r) {
  15       g.DrawEllipse(r);
  16    }
  17 }
  18 public class Box: Shape
  19 {
  20    public override void Paint(Graphics g, Rectangle r) {
  21       g.DrawRect(r);
  22    }
  23 }
  24 ]]></code_example>the Shape class defines the abstract notion of a geometrical shape object that can paint itself. The Paint method is abstract because there is no meaningful default implementation. The Ellipse and Box classes are concrete Shape implementations. Because these classes are non-abstract, they are required to override the Paint method and provide an actual implementation. end example]</example>
  25   </paragraph>
  26   <paragraph>It is a compile-time error for a <non_terminal where="14.5.8">base-access</non_terminal> (<hyperlink>14.5.8</hyperlink>) to reference an abstract method. <example>[Example: In the example <code_example><![CDATA[
  27 abstract class A
  28 {
  29    public abstract void F();
  30 }
  31 class B: A
  32 {
  33    public override void F() {
  34       base.F();            // Error, base.F is abstract
  35    }
  36 }
  37 ]]></code_example>a compile-time error is reported for the base.F() invocation because it references an abstract method. end example]</example> </paragraph>
  38   <paragraph>An abstract method declaration is permitted to override a virtual method. This allows an abstract class to force re-implementation of the method in derived classes, and makes the original implementation of the method unavailable. <example>[Example: In the example <code_example><![CDATA[
  39 using System;
  40 class A
  41 {
  42    public virtual void F() {
  43       Console.WriteLine("A.F");
  44    }
  45 }
  46 abstract class B: A
  47 {
  48    public abstract override void F();
  49 }
  50 class C: B
  51 {
  52    public override void F() {
  53       Console.WriteLine("C.F");
  54    }
  55 }
  56 ]]></code_example>class A declares a virtual method, class B overrides this method with an abstract method, and class C overrides that abstract method to provide its own implementation. end example]</example> </paragraph>
  57 </clause>