Pages

Friday 11 January 2013

Partial Methods in C Sharp with example

A partial method is a special method that exist with in a partial class or struct. One part of the partial class or struct have only partial method declaration means signature and another part of the same partial class or struct may have implementation for that partial method. If the implementation is not provided for declared partial method, the method and all calls to that partial methods will be removed at compile time. For more about Partial Class, Interface or Struct refer the article Partial Class, Interface or Struct in C Sharp with example

Why partial methods required ?

Partial methods are particularly helpful for customizing auto generated code by the tool. Whenever the tool generate the code then tool may decalare some partial method and implementation of these methods is decided by the developers.
If you are using entity framework for making DAL then you have seen that the Visual Studio make a partial method OnContextCreated() as shown below. Now the implementation of it depends on you whether you want to use it or not.
  1. public partial class DALEntities : ObjectContext
  2. {
  3. #region Constructors
  4. // Constructors for DALentities
  5. #endregion
  6. #region Partial Methods
  7. partial void OnContextCreated();
  8. #endregion
  9. }
  10. // This part can be put in the separate file
  11. public partial class DALEntities : ObjectContext
  12. {
  13. partial void OnContextCreated()
  14. {
  15. // put method implementation code
  16. Debug.WriteLine("OnContextCreated partial method");
  17. }
  18. }

Key points about partial method

  1. Partial methods can be declared or defined with in the partial class or struct.
  2. Partial methods are implicitly private and declarations must have partial keyword.
  3. Partial methods must return void.
  4. Partial methods implementation is optional.
  5. Partial methods can be static and unsafe and generic.
  6. Partial methods can have ref parameters but not out parameters since these can't return value.
  7. You cannot make a delegate to a partial method.
  8. The signatures of partial method will be same in both parts of the partial class or struct.
  1. partial class Example
  2. {
  3. partial void ExampleMethod(string s);
  4. }
  5. // This part can be put in the separate file
  6. partial class Example { //Implement the method
  7. partial void ExampleMethod(String s)
  8. {
  9. Console.WriteLine("Your string: {0}", s);
  10. }
  11. }

No comments:

Post a Comment