.NET Tip: Using Extension Methods

Extension methods allow you to add functionality to existing classes by modifying the original class or using partial classes. In fact, you don't need access to the source of the class at all. You can extend third-party classes and built-in classes as easily as you can extend your own classes. To demonstrate this, I will take the code from a previous tip that uses reflection to display information about an object passed to it and convert it to be an extension method instead. Here is the code for the original DisplayObjectInfo method:

public static string DisplayObjectInfo(Object o)
{
   StringBuilder sb = new StringBuilder();

   // Include the type of the object
   System.Type type = o.GetType();
   sb.Append("Type: " + type.Name);

   // Include information for each Field
   sb.Append("\r\n\r\nFields:");
   System.Reflection.FieldInfo[] fi = type.GetFields();
   if (fi.Length > 0)
   {
      foreach (FieldInfo f in fi)
      {
         sb.Append("\r\n " + f.ToString() + " = " +
                   f.GetValue(o));
      }
   }
   else
      sb.Append("\r\n None");

   // Include information for each Property
   sb.Append("\r\n\r\nProperties:");
   System.Reflection.PropertyInfo[] pi = type.GetProperties();
   if (pi.Length > 0)
   {
      foreach (PropertyInfo p in pi)
      {
         sb.Append("\r\n " + p.ToString() + " = " +
                   p.GetValue(o, null));
      }
   }
   else
      sb.Append("\r\n None");

   return sb.ToString();
}

This is how you call the DisplayObjectionInfo method:

GPSLocation Location = new GPSLocation(39, -86, 50, 180);
Debug.Print(Util.DisplayObjectInfo(Location));

And here is the output:

Type: GPSLocation

Fields:
   None

Properties:
   Double Latitude  = 39
   Double Longitude = -86
   Int32 Speed      = 50
   Int32 Direction  = 180

There are only a couple things that you need to do to make this into an extension method. First, all extension methods must be defined in a non-generic static class. Second, your method needs to accept a parameter of the type you want to extend. In this case, I want to extend the object data type, so I simply have to prepend the this keyword before the data type of the parameter to the DisplayObjectInfo function. So, my new definition of DisplayObjectInfo as an extension method looks like this:

public static class Util2008
{
   public static string DisplayObjectInfo(this Object o)
   {
      ...
   }
}

The body of the method does not change at all. Take a look at how you use the new extension method.

GPSLocation Location = new GPSLocation(39, -86, 50, 180);
Debug.Print(Location.DisplayObjectInfo());

Now, instead of passing the Location object to the DisplayObjectInfo method, the method has become a part of the Location class. Extension methods are fully integrated into the development environment. This means that your extension methods will show up with Intellisense. Take time to explore extension methods further to see how you can take best advantage of them in your applications.

About the Author

Jay Miller is a Software Engineer with Electronic Tracking Systems, a company dedicated to robbery prevention, apprehension, and recovery based in Carrollton, Texas. Jay has been working with .NET since the release of the first beta and is co-author of Learn Microsoft Visual Basic.Net In a Weekend. Jay can be reached via email at jmiller@sm-ets.com.



Comments

  • There are no comments yet. Be the first to comment!

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • A majority of organizations are operating under the assumption that their network has already been compromised, or will be, according to a survey conducted by the SANS Institute. With many high profile breaches in 2013 occurring on endpoints, interest in improving endpoint security is top-of-mind for many information security professionals. The full results of the inaugural SANS Endpoint Security Survey are summarized in this white paper to help information security professionals track trends in endpoint …

  • Java developers know that testing code changes can be a huge pain, and waiting for an application to redeploy after a code fix can take an eternity. Wouldn't it be great if you could see your code changes immediately, fine-tune, debug, explore and deploy code without waiting for ages? In this white paper, find out how that's possible with a Java plugin that drastically changes the way you develop, test and run Java applications. Discover the advantages of this plugin, and the changes you can expect to see …

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds