- 
                Notifications
    
You must be signed in to change notification settings  - Fork 6.1k
 
Clarify that abstract classes can contain implemented methods alongside abstract members #47667
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
          
     Merged
      
      
    
  
     Merged
                    Changes from 4 commits
      Commits
    
    
            Show all changes
          
          
            7 commits
          
        
        Select commit
          Hold shift + click to select a range
      
      5518bf5
              
                Initial plan
              
              
                Copilot c366f66
              
                Add clarification and example for abstract classes with implemented m…
              
              
                Copilot 69fb5a8
              
                Address feedback: use expression-bodied members, update syntax, and t…
              
              
                Copilot 4dfee48
              
                Update docs/csharp/language-reference/keywords/snippets/abstract/Prog…
              
              
                BillWagner 2fd7a2a
              
                Address feedback: move to snippets/shared, rename classes, add blank …
              
              
                Copilot 5318251
              
                Delete redundant abstract.csproj file as requested
              
              
                Copilot be06bc0
              
                Apply suggestions from code review
              
              
                BillWagner File filter
Filter by extension
Conversations
          Failed to load comments.   
        
        
          
      Loading
        
  Jump to
        
          Jump to file
        
      
      
          Failed to load files.   
        
        
          
      Loading
        
  Diff view
Diff view
There are no files selected for viewing
  
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters
    
  
  
    
              
              | Original file line number | Diff line number | Diff line change | 
|---|---|---|
| 
          
            
          
           | 
    @@ -12,8 +12,22 @@ | |
| # abstract (C# Reference) | ||
| 
     | 
||
| The `abstract` modifier indicates that the thing being modified has a missing or incomplete implementation. The abstract modifier can be used with classes, methods, properties, indexers, and events. Use the `abstract` modifier in a class declaration to indicate that a class is intended only to be a base class of other classes, not instantiated on its own. Members marked as abstract must be implemented by non-abstract classes that derive from the abstract class. | ||
| 
     | 
||
| Abstract classes can contain both abstract members (which have no implementation and must be overridden in derived classes) and fully implemented members (such as regular methods, properties, and constructors). This allows abstract classes to provide common functionality while still requiring derived classes to implement specific abstract members. | ||
| 
     | 
||
| ## Example 1 | ||
| ## Example 1 - Abstract class with mixed members | ||
| 
     | 
||
| The following example demonstrates an abstract class that contains both implemented methods and abstract members: | ||
| 
     | 
||
| :::code language="csharp" source="snippets/abstract/Program.cs" id="snippet1"::: | ||
| 
     | 
||
| In this example, the `Vehicle` abstract class provides: | ||
| - **Implemented members**: `GetInfo()` method, `StartEngine()` method, and constructor - these provide common functionality for all vehicles | ||
| 
         Check failure on line 25 in docs/csharp/language-reference/keywords/abstract.md 
    
   | 
||
                
      
                  BillWagner marked this conversation as resolved.
               
              
                Outdated
          
            Show resolved
            Hide resolved
         | 
||
| - **Abstract members**: `Move()` method and `MaxSpeed` property - these must be implemented by each specific vehicle type | ||
                
      
                  BillWagner marked this conversation as resolved.
               
              
                Outdated
          
            Show resolved
            Hide resolved
         | 
||
| 
     | 
||
| This design allows the abstract class to provide shared functionality while ensuring that derived classes implement vehicle-specific behavior. | ||
| 
     | 
||
| ## Example 2 | ||
| 
     | 
||
| In this example, the class `Square` must provide an implementation of `GetArea` because it derives from `Shape`: | ||
| 
     | 
||
| 
        
          
        
         | 
    @@ -25,6 +39,8 @@ | |
| 
     | 
||
| - An abstract class may contain abstract methods and accessors. | ||
| 
     | 
||
| - An abstract class can also contain implemented methods, properties, fields, and other members that provide functionality to derived classes. | ||
| 
     | 
||
| - It is not possible to modify an abstract class with the [sealed](./sealed.md) modifier because the two modifiers have opposite meanings. The `sealed` modifier prevents a class from being inherited and the `abstract` modifier requires a class to be inherited. | ||
| 
     | 
||
| - A non-abstract class derived from an abstract class must include actual implementations of all inherited abstract methods and accessors. | ||
| 
          
            
          
           | 
    @@ -61,7 +77,7 @@ | |
| 
     | 
||
| [!code-csharp[csrefKeywordsModifiers#2](~/samples/snippets/csharp/VS_Snippets_VBCSharp/csrefKeywordsModifiers/CS/csrefKeywordsModifiers.cs#2)] | ||
| 
     | 
||
| ## Example 2 | ||
| ## Example 3 | ||
| 
     | 
||
| In this example, the class `DerivedClass` is derived from an abstract class `BaseClass`. The abstract class contains an abstract method, `AbstractMethod`, and two abstract properties, `X` and `Y`. | ||
| 
     | 
||
| 
        
          
        
         | 
    @@ -77,7 +93,7 @@ | |
| 
     | 
||
| Nonetheless, it is possible to use an abstract class constructor, as in the example below | ||
| 
     | 
||
| ## Example 3 | ||
| ## Example 4 | ||
| 
     | 
||
| [!code-csharp[csrefKeywordsModifiers#27](~/samples/snippets/csharp/VS_Snippets_VBCSharp/csrefKeywordsModifiers/CS/csrefKeywordsModifiers.cs#27)] | ||
| 
     | 
||
| 
          
            
          
           | 
    ||
        
          
          
            80 changes: 80 additions & 0 deletions
          
          80 
        
  docs/csharp/language-reference/keywords/snippets/abstract/Program.cs
  
  
      
      
   
        
      
      
    
  
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters
    
  
  
    
              
              | Original file line number | Diff line number | Diff line change | 
|---|---|---|
| @@ -0,0 +1,80 @@ | ||
| //<snippet1> | ||
                
      
                  BillWagner marked this conversation as resolved.
               
          
            Show resolved
            Hide resolved
         | 
||
| public abstract class Vehicle | ||
| { | ||
| protected string _brand; | ||
| 
     | 
||
| // Constructor - implemented method in abstract class | ||
| public Vehicle(string brand) => _brand = brand; | ||
| 
     | 
||
| // Implemented method - provides functionality that all vehicles share | ||
| public string GetInfo() => $"This is a {_brand} vehicle."; | ||
| 
     | 
||
| // Another implemented method | ||
| public virtual void StartEngine() => Console.WriteLine($"{_brand} engine is starting..."); | ||
| 
     | 
||
| // Abstract method - must be implemented by derived classes | ||
| public abstract void Move(); | ||
| 
     | 
||
| // Abstract property - must be implemented by derived classes | ||
| public abstract int MaxSpeed { get; } | ||
| } | ||
| 
     | 
||
| public class Car : Vehicle | ||
| { | ||
| public Car(string brand) : base(brand) { } | ||
| 
     | 
||
| // Implementation of abstract method | ||
| public override void Move() => Console.WriteLine($"{_brand} car is driving on the road."); | ||
| 
     | 
||
| // Implementation of abstract property | ||
| public override int MaxSpeed => 200; | ||
| } | ||
| 
     | 
||
| public class Boat : Vehicle | ||
| { | ||
| public Boat(string brand) : base(brand) { } | ||
| 
     | 
||
| // Implementation of abstract method | ||
| public override void Move() => Console.WriteLine($"{_brand} boat is sailing on the water."); | ||
| 
     | 
||
| // Implementation of abstract property | ||
| public override int MaxSpeed => 50; | ||
| } | ||
| 
     | 
||
| class Program | ||
| { | ||
| static void Main() | ||
                
      
                  BillWagner marked this conversation as resolved.
               
              
                Outdated
          
            Show resolved
            Hide resolved
         | 
||
| { | ||
| // Cannot instantiate abstract class: Vehicle v = new Vehicle("Generic"); // Error! | ||
| 
     | 
||
| Car car = new Car("Toyota"); | ||
| Boat boat = new Boat("Yamaha"); | ||
| 
     | 
||
| // Using implemented methods from abstract class | ||
| Console.WriteLine(car.GetInfo()); | ||
| car.StartEngine(); | ||
| 
     | 
||
| // Using abstract methods implemented in derived class | ||
| car.Move(); | ||
| Console.WriteLine($"Max speed: {car.MaxSpeed} km/h"); | ||
| 
     | 
||
| Console.WriteLine(); | ||
| 
     | 
||
| Console.WriteLine(boat.GetInfo()); | ||
| boat.StartEngine(); | ||
| boat.Move(); | ||
| Console.WriteLine($"Max speed: {boat.MaxSpeed} km/h"); | ||
| } | ||
| } | ||
| /* Output: | ||
| This is a Toyota vehicle. | ||
| Toyota engine is starting... | ||
| Toyota car is driving on the road. | ||
| Max speed: 200 km/h | ||
| This is a Yamaha vehicle. | ||
| Yamaha engine is starting... | ||
| Yamaha boat is sailing on the water. | ||
| Max speed: 50 km/h | ||
| */ | ||
| //</snippet1> | ||
        
          
          
            10 changes: 10 additions & 0 deletions
          
          10 
        
  docs/csharp/language-reference/keywords/snippets/abstract/abstract.csproj
  
  
      
      
   
        
      
      
    
  
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters
    
  
  
    
              | Original file line number | Diff line number | Diff line change | 
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
| 
     | 
||
| <PropertyGroup> | ||
| <OutputType>Exe</OutputType> | ||
| <TargetFramework>net9.0</TargetFramework> | ||
| <ImplicitUsings>enable</ImplicitUsings> | ||
| <Nullable>enable</Nullable> | ||
| </PropertyGroup> | ||
| 
     | 
||
| </Project> | 
      
      Oops, something went wrong.
        
    
  
  Add this suggestion to a batch that can be applied as a single commit.
  This suggestion is invalid because no changes were made to the code.
  Suggestions cannot be applied while the pull request is closed.
  Suggestions cannot be applied while viewing a subset of changes.
  Only one suggestion per line can be applied in a batch.
  Add this suggestion to a batch that can be applied as a single commit.
  Applying suggestions on deleted lines is not supported.
  You must change the existing code in this line in order to create a valid suggestion.
  Outdated suggestions cannot be applied.
  This suggestion has been applied or marked resolved.
  Suggestions cannot be applied from pending reviews.
  Suggestions cannot be applied on multi-line comments.
  Suggestions cannot be applied while the pull request is queued to merge.
  Suggestion cannot be applied right now. Please check back later.
  
    
  
    
Uh oh!
There was an error while loading. Please reload this page.