H2365 Override method %s.%s should match case of ancestor %s.%s (Delphi)

From RAD Studio
Jump to: navigation, search

Go Up to Error and Warning Messages (Delphi)

When overriding a method, the best practice is to match the case of the ancestor method. This prevents any downstream failure that would not be anticipated by a Delphi user, who expects case-insensitivity.


Hint H2365 is emitted in the following case:

  TClass1 = class
    procedure VirtualMethod; virtual; abstract;
  TClass2 = class(TClass1)
    procedure virtualmethod; override; 
procedure TClass2.virtualmethod;

Here are some situations in which Delphi is case-sensitive:

In unit declarations and uses clauses, unit names must match the file names in case. In other contexts (such as qualified identifiers), unit names are case insensitive. To avoid problems with unit references, refer to the unit source file explicitly:
uses MyUnit in "myunit.pas";
  • Registering components
When you write your own components and you want to register them, the register function that you declare must be written like this:
procedure Register;  <<-- Leading capital required.  
The name of the Register procedure is case-sensitive for design-time packages. If you declare a register procedure (lower-case), and even if hint H2365 is not emitted, you do not get the expected result; your component does not get registered. For more information, see Using the RegisterComponents Procedure.
  • Importing external functions
When importing external functions, the exact case used in the DLL must be preserved.