How To - Override a method

This section describes how you customize an existing window by overriding one of its methods.

The example is using the steps described in A Simple Client Customization as base, followed by additional steps showing how to override a method.

Pre-Requirements

A Simple Client Customization getting a customized form window named frmPersonInfo_Cust.

Override the method

• Open frmPersonInfo_Cust using View Code.
• In the source code, place the cursor on the row directly after the region Override, write override and press space
• A list of possible virtual methods should appear
• Choose ContractName in the list and press enter, getting the override base implementation.
   

  #region Overrides
  
  public override SalString ConstructName(SalString sFirstName, SalString sMiddleName, SalString sLastName)
  {
     return base.ConstructName(sFirstName, sMiddleName, sLastName);
  }
  
  #endregion

• Rewrite the overridden ContractName method making it call the base implementation to get its value, then revert the contents and return the result.
   

  #region Overrides
  
  public override SalString ConstructName(SalString sFirstName, SalString sMiddleName, SalString sLastName)
  {
     //return base.ConstructName(sFirstName, sMiddleName, sLastName);
     string name = base.ConstructName(sFirstName, sMiddleName, sLastName);
     return string.Join(" ", name.Split(new char[] { ' '}, StringSplitOptions.RemoveEmptyEntries).Reverse());
  }
  
  #endregion

Example: Asuming the base implementation returns Ford Fairlane, the overridden method will revert the result and return Fairlane Ford instead.

• Surround the the newly added method with Override marker snippet: Select entire method code -> Right mouse button context menu -> Surround width... -> My Code Snippets -> IFS-APF -> LAA Override marker snippet and specify the core method signature in it.

#region Overrides
		
#region Override: public virtual SalString ConstructName(SalString sFirstName, SalString sMiddleName, SalString sLastName)
public override SalString ConstructName(SalString sFirstName, SalString sMiddleName, SalString sLastName)
{
   //return base.ConstructName(sFirstName, sMiddleName, sLastName);
   string name = base.ConstructName(sFirstName, sMiddleName, sLastName);
   return string.Join(" ", name.Split(new char[] { ' '}, StringSplitOptions.RemoveEmptyEntries).Reverse());
}
#endregion

#endregion

• Compile and start IEE.
• Open the customized Person
• Press New
• Press the link label Full Name
• In the Full Name dialog, enter First Name = Ford and Last Name = Fairlane and press OK

Result

The overridden method will result in merging all the names in reversed order, being displayed in the Name field.