.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

  • "Security" is the number one issue holding business leaders back from the cloud. But does the reality match the perception? Keeping data close to home, on premises, makes business and IT leaders feel inherently more secure. But the truth is, cloud solutions can offer companies real, tangible security advantages. Before you assume that on-site is the only way to keep data safe, it's worth taking a comprehensive approach to evaluating risks. Doing so can lead to big benefits.

  • Cisco and Intel have harnessed flash memory technology and truly innovative system software to blast through the boundaries of today's I/O-bound server/storage architectures. See how they are bringing real-time responsiveness to data-intensive applications—for unmatched business advantage. Sponsored by Cisco and Intel® Partnering in Innovation

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds