Vanara/Core/Extensions/ReflectionExtensions.cs

435 lines
24 KiB
C#

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using System.Reflection.Emit;
namespace Vanara.Extensions.Reflection
{
/// <summary>Extensions for <see cref="object"/> related to <c>System.Reflection</c></summary>
public static class ReflectionExtensions
{
private const BindingFlags bindingFlags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.IgnoreCase;
/// <summary>Get a sequence of types that represent all base types and interfaces.</summary>
/// <param name="type">The type to evaluate.</param>
/// <returns>A sequence of types that represent all base types and interfaces.</returns>
public static IEnumerable<Type> EnumInheritance(this Type type)
{
foreach (var i in type.GetInterfaces())
yield return i;
while (type.BaseType != null)
yield return type = type.BaseType;
}
/// <summary>Searches for the constants defined for <paramref name="type"/>, using the specified binding constraints.</summary>
/// <param name="type">The type to search.</param>
/// <param name="bindingFlags">A bitwise combination of the enumeration values that specify how the search is conducted.</param>
/// <returns>
/// <para>
/// A sequence of <see cref="FieldInfo"/> objects representing all fields defined for <paramref name="type"/> that match the
/// specified binding constraints.
/// </para>
/// <para>-or-</para>
/// <para>
/// An empty sequence of type <see cref="FieldInfo"/>, if no fields are defined for <paramref name="type"/>, or if none of the
/// defined fields match the binding constraints.
/// </para>
/// </returns>
public static IEnumerable<FieldInfo> GetConstants(this Type type, BindingFlags bindingFlags = BindingFlags.Public) =>
type.GetFields(BindingFlags.Static | bindingFlags).Where(fi => fi.IsLiteral && !fi.IsInitOnly);
/// <summary>Gets a named field value from an object.</summary>
/// <typeparam name="T">The expected type of the field to be returned.</typeparam>
/// <param name="obj">The object from which to retrieve the field.</param>
/// <param name="fieldName">Name of the field.</param>
/// <returns>The field value.</returns>
public static T GetFieldValue<T>(this object obj, string fieldName)
{
if (obj is null) throw new ArgumentNullException(nameof(obj));
if (string.IsNullOrEmpty(fieldName)) throw new ArgumentNullException(nameof(fieldName));
return (T)obj.GetType().InvokeMember(fieldName, BindingFlags.GetField | bindingFlags, null, obj, null, null);
}
/// <summary>Gets a named field value from an object.</summary>
/// <typeparam name="T">The expected type of the field to be returned.</typeparam>
/// <param name="obj">The object from which to retrieve the field.</param>
/// <param name="fieldName">Name of the field.</param>
/// <param name="defaultValue">The default value to return in the instance that the field is not found.</param>
/// <returns>The field value, if found, or the <paramref name="defaultValue"/> if not.</returns>
public static T GetFieldValue<T>(this object obj, string fieldName, T defaultValue)
{
try { return GetFieldValue<T>(obj, fieldName); }
catch { return defaultValue; }
}
/// <summary>Gets a named property value from an object.</summary>
/// <typeparam name="T">The expected type of the property to be returned.</typeparam>
/// <param name="obj">The object from which to retrieve the property.</param>
/// <param name="propertyName">Name of the property.</param>
/// <returns>The property value.</returns>
public static T GetPropertyValue<T>(this object obj, string propertyName)
{
if (obj is null) throw new ArgumentNullException(nameof(obj));
return (T)obj.GetType().InvokeMember(propertyName, BindingFlags.GetProperty | bindingFlags, null, obj, null, null);
}
/// <summary>Gets a named property value from an object.</summary>
/// <typeparam name="T">The expected type of the property to be returned.</typeparam>
/// <param name="obj">The object from which to retrieve the property.</param>
/// <param name="propertyName">Name of the property.</param>
/// <param name="defaultValue">The default value to return in the instance that the property is not found.</param>
/// <returns>The property value, if found, or the <paramref name="defaultValue"/> if not.</returns>
public static T GetPropertyValue<T>(this object obj, string propertyName, T defaultValue)
{
try { return GetPropertyValue<T>(obj, propertyName); }
catch { return defaultValue; }
}
/// <summary>Determines if a type inherits from another type. The <paramref name="baseType"/> may be a generic type definition.</summary>
/// <param name="type">The type.</param>
/// <param name="baseType">The base type.</param>
/// <returns>
/// <see langword="true"/> if <paramref name="baseType"/> is found in the inheritance list for <paramref name="type"/>;
/// <see langword="false"/> otherwise.
/// </returns>
public static bool InheritsFrom(this Type type, Type baseType)
{
return !(type is null) && !(baseType is null) || type.BaseType != null && type.BaseType.IsGenericType && type.BaseType.GetGenericTypeDefinition().Equals(baseType) ||
type.BaseType.InheritsFrom(baseType) || baseType.IsAssignableFrom(type) || type.GetInterfaces().Any(i => i.IsGenericType && i.GetGenericTypeDefinition().Equals(baseType));
}
/// <summary>Determines if a type inherits from another type. The <typeparamref name="T"/> may be a generic type definition.</summary>
/// <typeparam name="T">The base type.</typeparam>
/// <param name="type">The type.</param>
/// <returns>
/// <see langword="true"/> if <typeparamref name="T"/> is found in the inheritance list for <paramref name="type"/>;
/// <see langword="false"/> otherwise.
/// </returns>
public static bool InheritsFrom<T>(this Type type) => type.InheritsFrom(typeof(T));
/// <summary>
/// Invokes a generic named method on an object with parameters and no return value.
/// </summary>
/// <param name="obj">The object on which to invoke the method or constructor. If a method is static, this argument is ignored. If a constructor is static, this argument must be null or an instance of the class that defines the constructor.</param>
/// <param name="methodName">The string containing the name of the public method to get.</param>
/// <param name="typeArguments">An array of types to be substituted for the type parameters of the current generic method definition.</param>
/// <param name="argTypes">An array of Type objects representing the number, order, and type of the parameters for the method to get.
/// <para>-or-</para>
/// <para>An empty array of Type objects(as provided by the EmptyTypes field) to get a method that takes no parameters.</para></param>
/// <param name="args">An argument list for the invoked method or constructor. This is an array of objects with the same number, order, and type as the parameters of the method or constructor to be invoked. If there are no parameters, this should be null.</param>
/// <returns>An Object containing the return value of the invoked method, or null in the case of a constructor, or null if the method's return type is void. Before calling the method or constructor, Invoke checks to see if the user has access permission and verifies that the parameters are valid.</returns>
/// <exception cref="ArgumentException">Method not found - methodName</exception>
public static object InvokeGenericMethod(this object obj, string methodName, Type[] typeArguments, Type[] argTypes, object[] args)
{
var mi = obj?.GetType().GetMethod(methodName, bindingFlags, null, argTypes, null);
if (mi == null) throw new ArgumentException(@"Method not found", nameof(methodName));
var gmi = mi.MakeGenericMethod(typeArguments);
return gmi.Invoke(obj, args);
}
/// <summary>Invokes a named method on an object with parameters and no return value.</summary>
/// <param name="obj">The object on which to invoke the method.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
public static void InvokeMethod(this object obj, string methodName, params object[] args)
{
var argTypes = args == null || args.Length == 0 ? Type.EmptyTypes : Array.ConvertAll(args,
o => o?.GetType() ?? typeof(object));
InvokeMethod(obj, methodName, argTypes, args);
}
/// <summary>Invokes a named method on an object with parameters and no return value.</summary>
/// <typeparam name="T">The expected type of the method's return value.</typeparam>
/// <param name="obj">The object on which to invoke the method.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
/// <returns>The value returned from the method.</returns>
public static T InvokeMethod<T>(this object obj, string methodName, params object[] args)
{
var argTypes = args == null || args.Length == 0 ? Type.EmptyTypes : Array.ConvertAll(args,
o => o?.GetType() ?? typeof(object));
return InvokeMethod<T>(obj, methodName, argTypes, args);
}
/// <summary>Invokes a named method on an object with parameters and no return value.</summary>
/// <param name="obj">The object on which to invoke the method.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="argTypes">The argument types.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
public static void InvokeMethod(this object obj, string methodName, Type[] argTypes, object[] args)
{
var mi = obj?.GetType().GetMethod(methodName, bindingFlags, null, argTypes, null);
if (mi == null) throw new ArgumentException(@"Method not found", nameof(methodName));
mi.Invoke(obj, args);
}
/// <summary>Invokes a named method on an object with parameters and no return value.</summary>
/// <typeparam name="T">The expected type of the method's return value.</typeparam>
/// <param name="obj">The object on which to invoke the method.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="argTypes">The argument types.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
/// <returns>The value returned from the method.</returns>
public static T InvokeMethod<T>(this object obj, string methodName, Type[] argTypes, object[] args)
{
var mi = obj?.GetType().GetMethod(methodName, bindingFlags, null, argTypes, null);
if (mi == null) throw new ArgumentException(@"Method not found", nameof(methodName));
var tt = typeof(T);
if (tt != typeof(object) && mi.ReturnType != tt && !mi.ReturnType.IsSubclassOf(tt))
throw new ArgumentException(@"Return type mismatch", nameof(T));
return (T)mi.Invoke(obj, args);
}
/// <summary>Sets a named field on an object.</summary>
/// <typeparam name="T">The type of the field to be set.</typeparam>
/// <typeparam name="TS">The type of the object on which to the set the field.</typeparam>
/// <param name="obj">The object on which to set the field.</param>
/// <param name="fieldName">Name of the field.</param>
/// <param name="value">The field value to set on the object.</param>
public static void SetFieldValue<T, TS>(this TS obj, string fieldName, T value) where TS : class
{
try { obj?.GetType().InvokeMember(fieldName, BindingFlags.SetField | bindingFlags, null, obj, new object[] { value }, null); }
catch { }
}
/// <summary>Sets a named field on an object.</summary>
/// <typeparam name="T">The type of the field to be set.</typeparam>
/// <typeparam name="TS">The type of the structure on which to the set the field.</typeparam>
/// <param name="obj">The object on which to set the field.</param>
/// <param name="fieldName">Name of the field.</param>
/// <param name="value">The field value to set on the object.</param>
public static void SetFieldValue<T, TS>(this ref TS obj, string fieldName, T value) where TS : struct
{
var tr = __makeref(obj);
var fi = typeof(TS).GetField(fieldName, bindingFlags);
if (fi is null) throw new MissingFieldException(typeof(TS).Name, fieldName);
fi.SetValueDirect(tr, value);
}
/// <summary>Sets a named property on an object.</summary>
/// <typeparam name="T">The type of the property to be set.</typeparam>
/// <param name="obj">The object on which to set the property.</param>
/// <param name="propName">Name of the property.</param>
/// <param name="value">The property value to set on the object.</param>
public static void SetPropertyValue<T>(this object obj, string propName, T value)
{
try { obj?.GetType().InvokeMember(propName, BindingFlags.SetProperty | bindingFlags, null, obj, new object[] { value }, null); }
catch { }
}
}
}
namespace Vanara.Extensions
{
using Vanara.Extensions.Reflection;
/// <summary>Extensions related to <c>System.Reflection</c></summary>
public static class ReflectionExtensions
{
private const BindingFlags staticBindingFlags = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.IgnoreCase;
/// <summary>For a structure, gets either the result of the static Create method or the default.</summary>
/// <typeparam name="T">The structure's type.</typeparam>
/// <returns>The result of the static Create method or the default.</returns>
public static T CreateOrDefault<T>() where T : struct
{
var mi = typeof(T).GetMethod("Create", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static, null, Type.EmptyTypes, null);
if (mi != null)
return (T)mi.Invoke(null, null);
var fi = typeof(T).GetField("Default", BindingFlags.Public | BindingFlags.Static);
if (fi != null)
return (T)fi.GetValue(null);
var pi = typeof(T).GetProperty("Default", BindingFlags.Public | BindingFlags.Static | BindingFlags.GetProperty, null, typeof(T), Type.EmptyTypes, null);
if (pi != null)
return (T)pi.GetValue(null);
return default;
}
/// <summary>Gets all loaded types in the <see cref="AppDomain"/>.</summary>
/// <param name="appDomain">The application domain.</param>
/// <returns>All loaded types.</returns>
public static IEnumerable<Type> GetAllTypes(this AppDomain appDomain) => appDomain.GetAssemblies().SelectMany(a => a.GetTypes());
/// <summary>Returns an array of custom attributes applied to this member and identified by <typeparamref name="TAttr"/>.</summary>
/// <typeparam name="TAttr">The type of attribute to search for. Only attributes that are assignable to this type are returned.</typeparam>
/// <param name="element">An object derived from the MemberInfo class that describes a constructor, event, field, method, or property member of a class.</param>
/// <param name="inherit"><c>true</c> to search this member's inheritance chain to find the attributes; otherwise, <c>false</c>. This parameter is ignored for properties and events.</param>
/// <param name="predicate">An optional predicate to refine the results.</param>
/// <returns></returns>
public static IEnumerable<TAttr> GetCustomAttributes<TAttr>(this MemberInfo element, bool inherit = false, Func<TAttr, bool> predicate = null) where TAttr : Attribute =>
element.GetCustomAttributes(typeof(TAttr), inherit).Cast<TAttr>().Where(predicate ?? (a => true));
/// <summary>Returns an array of custom attributes applied to this member and identified by <typeparamref name="TAttr"/>.</summary>
/// <typeparam name="TAttr">The type of attribute to search for. Only attributes that are assignable to this type are returned.</typeparam>
/// <param name="type">The type of the <see cref="Type"/> to examine.</param>
/// <param name="inherit"><c>true</c> to search this member's inheritance chain to find the attributes; otherwise, <c>false</c>. This parameter is ignored for properties and events.</param>
/// <param name="predicate">An optional predicate to refine the results.</param>
/// <returns></returns>
public static IEnumerable<TAttr> GetCustomAttributes<TAttr>(this Type type, bool inherit = false, Func<TAttr, bool> predicate = null) where TAttr : Attribute =>
type.GetCustomAttributes(typeof(TAttr), inherit).Cast<TAttr>().Where(predicate ?? (a => true));
/// <summary>Finds the type of the element of a type. Returns null if this type does not enumerate.</summary>
/// <param name="type">The type to check.</param>
/// <returns>The element type, if found; otherwise, <see langword="null"/>.</returns>
public static Type FindElementType(this Type type)
{
if (type.IsArray)
return type.GetElementType();
// type is IEnumerable<T>;
if (ImplIEnumT(type))
return type.GetGenericArguments().First();
// type implements/extends IEnumerable<T>;
var enumType = type.GetInterfaces().Where(ImplIEnumT).Select(t => t.GetGenericArguments().First()).FirstOrDefault();
if (enumType != null)
return enumType;
// type is IEnumerable
if (IsIEnum(type) || type.GetInterfaces().Any(IsIEnum))
return typeof(object);
return null;
bool IsIEnum(Type t) => t == typeof(System.Collections.IEnumerable);
bool ImplIEnumT(Type t) => t.IsGenericType && t.GetGenericTypeDefinition() == typeof(IEnumerable<>);
}
/// <summary>Gets the fields of a structure with sequential layout in the order in which they appear in memory.</summary>
/// <param name="type">The type of the structure.</param>
/// <param name="bindingFlags">The binding flags.</param>
/// <returns>An ordered sequence of <see cref="FieldInfo"/> instances representing the fields in the structure.</returns>
public static IEnumerable<FieldInfo> GetOrderedFields(this Type type, BindingFlags bindingFlags = BindingFlags.Public | BindingFlags.Instance) =>
type.GetFields(bindingFlags).Select(fi => (System.Runtime.InteropServices.Marshal.OffsetOf(type, fi.Name).ToInt64(), fi)).OrderBy(t => t.Item1).Select(t => t.fi);
/// <summary>Gets a named field value from an object.</summary>
/// <typeparam name="T">The expected type of the field to be returned.</typeparam>
/// <param name="fieldName">Name of the field.</param>
/// <returns>The field value.</returns>
public static T GetStaticFieldValue<T>(string fieldName)
{
if (string.IsNullOrEmpty(fieldName)) throw new ArgumentNullException(nameof(fieldName));
return (T)typeof(T).InvokeMember(fieldName, BindingFlags.GetField | staticBindingFlags, null, null, null);
}
/// <summary>Invokes a named method on a created instance of a type with parameters.</summary>
/// <typeparam name="T">The expected type of the method's return value.</typeparam>
/// <param name="type">The type to be instantiated and then used to invoke the method. This method assumes the type has a default public constructor.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
/// <returns>The value returned from the method.</returns>
public static T InvokeMethod<T>(this Type type, string methodName, params object[] args)
{
var o = Activator.CreateInstance(type);
return o.InvokeMethod<T>(methodName, args);
}
/// <summary>Invokes a named method on a created instance of a type with parameters.</summary>
/// <typeparam name="T">The expected type of the method's return value.</typeparam>
/// <param name="type">The type to be instantiated and then used to invoke the method.</param>
/// <param name="instArgs">The arguments to supply to the constructor.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
/// <returns>The value returned from the method.</returns>
public static T InvokeMethod<T>(this Type type, object[] instArgs, string methodName, params object[] args)
{
var o = Activator.CreateInstance(type, instArgs);
return o.InvokeMethod<T>(methodName, args);
}
/// <summary>Invokes a named static method of a type with parameters.</summary>
/// <typeparam name="T">The expected type of the method's return value.</typeparam>
/// <param name="type">The type containing the static method.</param>
/// <param name="methodName">Name of the method.</param>
/// <param name="args">The arguments to provide to the method invocation.</param>
/// <returns>The value returned from the method.</returns>
public static T InvokeStaticMethod<T>(this Type type, string methodName, params object[] args)
{
var argTypes = args == null || args.Length == 0 ? Type.EmptyTypes : Array.ConvertAll(args, o => o?.GetType() ?? typeof(object));
var mi = type.GetMethod(methodName, staticBindingFlags, null, argTypes, null);
if (mi == null) throw new ArgumentException(@"Method not found", nameof(methodName));
return (T)mi.Invoke(null, args);
}
#if !NETSTANDARD2_0
/// <summary>Invokes a method from a derived base class.</summary>
/// <param name="methodInfo">The <see cref="MethodInfo"/> instance from the derived class for the method to invoke.</param>
/// <param name="targetObject">The target object.</param>
/// <param name="arguments">The arguments.</param>
/// <returns>The value returned from the method.</returns>
public static object InvokeNotOverride(this MethodInfo methodInfo, object targetObject, params object[] arguments)
{
var parameters = methodInfo.GetParameters();
if (parameters.Length != arguments.Length)
throw new Exception("Arguments count doesn't match");
Type returnType = null;
if (methodInfo.ReturnType != typeof(void))
returnType = methodInfo.ReturnType;
var type = targetObject.GetType();
var dynamicMethod = new DynamicMethod("", returnType, new[] { type, typeof(object) }, type);
var iLGenerator = dynamicMethod.GetILGenerator();
iLGenerator.Emit(OpCodes.Ldarg_0); // this
for (var i = 0; i < parameters.Length; i++)
{
var parameter = parameters[i];
iLGenerator.Emit(OpCodes.Ldarg_1); // load array argument
// get element at index
iLGenerator.Emit(OpCodes.Ldc_I4_S, i); // specify index
iLGenerator.Emit(OpCodes.Ldelem_Ref); // get element
var parameterType = parameter.ParameterType;
iLGenerator.Emit(OpCodes.Unbox_Any, parameterType);
}
iLGenerator.Emit(OpCodes.Call, methodInfo);
iLGenerator.Emit(OpCodes.Ret);
return dynamicMethod.Invoke(null, new[] { targetObject, arguments });
}
#endif
/// <summary>Determines whether the specified method is compatible with a delegate.</summary>
/// <typeparam name="TDel">The type of the delegate.</typeparam>
/// <param name="method">The method information.</param>
/// <returns><see langword="true"/> if method is compatible with the delegate; otherwise, <see langword="false"/>.</returns>
public static bool IsMethodCompatibleWithDelegate<TDel>(this MethodInfo method) where TDel : Delegate
{
var delegateSignature = typeof(TDel).GetMethod("Invoke");
return delegateSignature.ReturnType == method.ReturnType && delegateSignature.GetParameters().Select(x => x.ParameterType).SequenceEqual(method.GetParameters().Select(x => x.ParameterType));
}
/// <summary>Loads a type from a named assembly.</summary>
/// <param name="typeName">Name of the type.</param>
/// <param name="asmRef">The name or path of the file that contains the manifest of the assembly.</param>
/// <returns>The <see cref="Type"/> reference, or <c>null</c> if type or assembly not found.</returns>
public static Type LoadType(string typeName, string asmRef = null)
{
Assembly asm = null;
try { asm = Assembly.LoadFrom(asmRef); } catch { }
if (!TryGetType(asm, typeName, out var ret))
{
foreach (var asm2 in AppDomain.CurrentDomain.GetAssemblies())
if (TryGetType(asm2, typeName, out ret)) break;
}
return ret;
}
/// <summary>Tries the retrieve a <see cref="Type"/> reference from an assembly.</summary>
/// <param name="typeName">Name of the type.</param>
/// <param name="asm">The assembly from which to load the type.</param>
/// <param name="type">The <see cref="Type"/> reference, if found.</param>
/// <returns><c>true</c> if the type was found in the assembly; otherwise, <c>false</c>.</returns>
private static bool TryGetType(Assembly asm, string typeName, out Type type)
{
type = asm?.GetType(typeName, false, false);
return !(type is null);
}
}
}