{"id":2703,"date":"2010-01-06T11:49:00","date_gmt":"2010-01-06T11:49:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudio\/2010\/01\/06\/getting-information-about-objects-types-and-members-with-expression-trees\/"},"modified":"2022-10-17T15:07:24","modified_gmt":"2022-10-17T22:07:24","slug":"getting-information-about-objects-types-and-members-with-expression-trees","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/visualstudio\/getting-information-about-objects-types-and-members-with-expression-trees\/","title":{"rendered":"Getting Information About Objects, Types, and Members with Expression Trees"},"content":{"rendered":"

Starting with C# 3.0 and Visual Studio 2008, you can use expression trees to get information about objects, types, and members. In this post I\u2019m going to show some examples and explain what benefits you can get by using this technique. If you are not familiar with expression trees, I would recommend reading Charlie Calvert\u2019s blog post Expression Tree Basics<\/a> first.<\/p>\n

Let\u2019s start with a simple task. Assume that you want to print the name of a field or a property next to its value. For example, imagine that you have the following class.<\/p>\n

\n
\n
public class SampleClass\n{\npublic string SomeField = “Test”;\n}<\/div>\n<\/div>\n<\/div>\n

Of course, there is a straightforward solution:<\/p>\n

\n
\n
SampleClass sample = new SampleClass();\nConsole.WriteLine(“SomeField : {0}”, sample.SomeField);\n\/\/ Prints SomeField : Test<\/div>\n<\/div>\n<\/div>\n

The problem with the above code is that you use a string literal SomeField<\/span>. Nothing guarantees that this is the real name of the field. You might type the name incorrectly or just accidentally specify the wrong name. Furthermore, if you rename your property to, say, AnotherField<\/span>, it could be hard to find a string literal that represents its name.<\/p>\n

Here is how you can create a method that returns a property name by using expression trees, without using any string literals:<\/p>\n

\n
\n
public static string GetName<T>(Expression<Func<T>> e)\n{\nvar member = (MemberExpression)e.Body;\nreturn member.Member.Name;\n}<\/div>\n<\/div>\n<\/div>\n

To call this method, you need to give it a lambda expression, as shown below.<\/p>\n

\n
\n
Console.WriteLine(“{0} : {1}”,\nGetName(() => sample.SomeField), sample.SomeField);\n\/\/ Also prints SomeField : Test<\/div>\n<\/div>\n<\/div>\n

Because of the lambda expression, you get not only compile-time error checking, but also full IntelliSense support when typing a member name. And if you rename a property, the compiler will find all the places where the property name is used. Or you can rely on refactoring tools to rename all the instances of the property for you.<\/p>\n

In fact, you can also use this method to get the name of the variable itself (which can be convenient for tracing and logging).<\/p>\n

\n
\n
Console.WriteLine(“{0} : {1}”, GetName(() => sample), sample);\n\/\/Prints sample : SampleClass<\/div>\n<\/div>\n<\/div>\n

The only problem with using a lambda expression is that you need to ensure that the user passes the correct one. For example, the user of your method can pass a lambda expression like () => new SampleClass()<\/span>. Unfortunately, you can\u2019t get a compile check for this. So, when using a lambda expression, make sure that you really get the expression you expect. For example, like this:<\/p>\n

\n
\n
\n

public static string GetName<T>(Expression<Func<T>> e)\n{\nvar member = e.Body as MemberExpression;<\/p>\n

\/\/ If the method gets a lambda expression\n\/\/ that is not a member access,\n\/\/ for example, () => x + y, an exception is thrown.\nif (member != null)\nreturn member.Member.Name;\nelse\nthrow new ArgumentException(\n“‘” + e +\n“‘: is not a valid expression for this method”);\n}<\/p>\n<\/div>\n<\/div>\n<\/div>\n

One more scenario where expression trees can help you is getting information about members of a type. C# provides the typeof<\/a> operator to get type information, but does not provide operators like memberof<\/b> or infoof<\/b>. You can use reflection methods such as Type.GetField()<\/a>, Type.GetMethod()<\/a>, and so on, but then you have to use string literals again.<\/p>\n

\n
\n
\n

\/\/ By using typeof operator, you can get type information\n\/\/ without using string literals.\nType type = typeof(SampleClass);<\/p>\n

\/\/ But to get information about a member by using reflection,\n\/\/ you have to rely on string literals.\nFieldInfo fieldInfo = type.GetField(“SomeField”);<\/p>\n

Console.WriteLine(fieldInfo);\n\/\/ Prints System.String SomeField<\/p>\n<\/div>\n<\/div>\n<\/div>\n

The problem gets worse if you have overloaded methods in your class.<\/p>\n

\n
\n
public class SampleClass\n{\npublic string SomeField = “Test”;\npublic void SomeMethod() { }\npublic void SomeMethod(string arg) { }\n}<\/div>\n<\/div>\n<\/div>\n

In this case, you need to specify a method and also its parameters.<\/p>\n

\n
\n
MethodInfo methodInfo = type.GetMethod(\n“SomeMethod”, new Type[] { typeof(String) });\nConsole.WriteLine(methodInfo);\n\/\/ Prints Void SomeMethod(System.String)<\/div>\n<\/div>\n<\/div>\n

Now you have more ways to get yourself into trouble. In addition to explicitly specifying the name of your method, you\u2019ve also specified the number and types of its parameters. So any changes in the method signature can affect the behavior of your program, and the compiler will not detect it.<\/p>\n

With expression trees you can get the same information without using string literals, and also get the compiler to check whether the member you need exists. Furthermore, all you need to do to get a necessary method overload is provide an example of the method usage within a lambda expression. Thanks to Mads Torgersen, a Visual Studio Program Manager, for providing the following code example.<\/p>\n

\n
\n
\n

public static MemberInfo MemberOf<T>(Expression<Func<T>> e)\n{\nreturn MemberOf(e.Body);\n}<\/p>\n

\/\/ We need to add this overload to cover scenarios\n\/\/ when a method has a void return type.\npublic static MemberInfo MemberOf(Expression<Action> e)\n{\nreturn MemberOf(e.Body);\n}<\/p>\n

private static MemberInfo MemberOf(Expression body)\n{\n{\nvar member = body as MemberExpression;\nif (member != null) return member.Member;\n}<\/p>\n

{\nvar method = body as MethodCallExpression;\nif (method != null) return method.Method;\n}<\/p>\n

throw new ArgumentException(\n“‘” + body + “‘: not a member access”);\n}<\/p>\n<\/div>\n<\/div>\n<\/div>\n

Now you can use the MemberOf<\/span> method for all kinds of scenarios, for both instance and static members.<\/p>\n

\n
\n
\n

Console.WriteLine(MemberOf(() => sample.SomeField));\n\/\/ Prints System.String SomeField<\/p>\n

\/\/ To choose a particular method overload,\n\/\/ you simply show the usage of the method.\nConsole.WriteLine(MemberOf(() => sample.SomeMethod(“Test”)));\n\/\/ Prints Void SomeMethod(System.String)<\/p>\n

Console.WriteLine(MemberOf(() => sample.SomeMethod()));\n\/\/ Prints Void SomeMethod()<\/p>\n

Console.WriteLine(MemberOf(() => Console.Out));\n\/\/ Prints System.IO.TextWriter Out<\/p>\n<\/div>\n<\/div>\n<\/div>\n

I want to repeat that this functionality is already available in C# 3.0 and .NET Framework 3.5. If you want to know how expression trees are extended in .NET Framework 4, take a look at one of my previous posts: Generating Dynamic Methods with Expression Trees in Visual Studio 2010<\/a>.<\/p>\n

Update<\/strong><\/p>\n

See also a\u00a0follow-up post: How can I get objects and property values from expression trees?<\/a><\/p>\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

Starting with C# 3.0 and Visual Studio 2008, you can use expression trees to get information about objects, types, and members. In this post I\u2019m going to show some examples and explain what benefits you can get by using this technique. If you are not familiar with expression trees, I would recommend reading Charlie Calvert\u2019s […]<\/p>\n","protected":false},"author":13,"featured_media":255385,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[155],"tags":[3,5],"class_list":["post-2703","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-visual-studio","tag-net-framework","tag-csharp"],"acf":[],"blog_post_summary":"

Starting with C# 3.0 and Visual Studio 2008, you can use expression trees to get information about objects, types, and members. In this post I\u2019m going to show some examples and explain what benefits you can get by using this technique. If you are not familiar with expression trees, I would recommend reading Charlie Calvert\u2019s […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/2703","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/comments?post=2703"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/2703\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media\/255385"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media?parent=2703"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/categories?post=2703"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/tags?post=2703"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}