/// <summary>
        /// Invoke the best available match for the supplied parameters. If no method can be called
        /// using the supplied parameters, an exception is thrown.
        /// </summary>
        /// <param name="obj">The object on which to invoke a method.</param>
        /// <param name="mustUseAllParameters">Specifies whether all supplied parameters must be used in the
        /// invocation. Unless you know what you are doing you should pass true for this parameter.</param>
        /// <param name="sample">The object whose public properties will be used as parameters.</param>
        /// <returns>The return value of the invocation.</returns>
        public object Invoke(object obj, bool mustUseAllParameters, object sample)
        {
            if (obj == null || sample == null)
            {
                throw new ArgumentException("Missing or invalid argument: " + (obj == null ? "obj" : "sample"));
            }
            SourceInfo sourceInfo = SourceInfo.CreateFromType(sample.GetType());

            // check to see if we already have a map for best match
            MethodMap map = mapCache.Get(sourceInfo);

            object[] values = sourceInfo.GetParameterValues(sample);
            if (map == null)
            {
                string[] names = sourceInfo.ParamNames;
                Type[]   types = sourceInfo.ParamTypes;
                if (names.Length != values.Length || names.Length != types.Length)
                {
                    throw new ArgumentException("Mismatching name, type and value arrays (must be of identical length).");
                }
                map = MapFactory.DetermineBestMethodMatch(methodPool, mustUseAllParameters, names, types, values);
                mapCache.Insert(sourceInfo, map);
            }
            bool isStatic = obj is Type;

            return(isStatic ? map.Invoke(values) : map.Invoke(obj, values));
        }
        /// <summary>
        /// Invoke the best available match for the supplied parameters.
        /// If no method can be called using the supplied parameters, an exception is thrown.
        /// </summary>
        /// <param name="obj">The object on which to invoke a method.</param>
        /// <param name="mustUseAllParameters">Specifies whether all supplied parameters must be used in the
        /// invocation. Unless you know what you are doing you should pass true for this parameter.</param>
        /// <param name="parameters">A dictionary of parameter name/value pairs.</param>
        /// <returns>The return value of the invocation.</returns>
        public object Invoke(object obj, bool mustUseAllParameters, Dictionary <string, object> parameters)
        {
            bool isStatic = obj is Type;

            string[] names  = parameters.Keys.ToArray() ?? new string[0];
            object[] values = parameters.Values.ToArray() ?? new object[0];
            Type[]   types  = values.ToTypeArray() ?? new Type[0];
            if (names.Length != values.Length || names.Length != types.Length)
            {
                throw new ArgumentException("Mismatching name, type and value arrays (must be of identical length).");
            }
            MethodMap map = MapFactory.DetermineBestMethodMatch(methodPool, mustUseAllParameters, names, types, values);

            return(isStatic ? map.Invoke(values) : map.Invoke(obj, values));
        }
        /// <summary>
        /// Invoke the best available match for the supplied parameters.
        /// If no method can be called using the supplied parameters, an exception is thrown.
        /// </summary>
        /// <param name="obj">The object on which to invoke a method.</param>
        /// <param name="mustUseAllParameters">Specifies whether all supplied parameters must be used in the
        /// invocation. Unless you know what you are doing you should pass true for this parameter.</param>
        /// <param name="sample">The object whose public properties will be used as parameters.</param>
        /// <returns>The return value of the invocation.</returns>
        public object Invoke(object obj, bool mustUseAllParameters, object sample)
        {
            Type sourceType = sample.GetType();
            var  sourceInfo = new SourceInfo(sourceType);
            bool isStatic   = obj is Type;

            string[] names  = sourceInfo.ParamNames;
            Type[]   types  = sourceInfo.ParamTypes;
            object[] values = sourceInfo.GetParameterValues(sample);
            if (names.Length != values.Length || names.Length != types.Length)
            {
                throw new ArgumentException("Mismatching name, type and value arrays (must be of identical length).");
            }
            MethodMap map = MapFactory.DetermineBestMethodMatch(methodPool, mustUseAllParameters, names, types, values);

            return(isStatic ? map.Invoke(values) : map.Invoke(obj, values));
        }
        /// <summary>
        /// Invoke the best available match for the supplied parameters.
        /// If no method can be called using the supplied parameters, an exception is thrown.
        /// </summary>
        /// <param name="obj">The object on which to invoke a method.</param>
        /// <param name="mustUseAllParameters">Specifies whether all supplied parameters must be used in the
        /// invocation. Unless you know what you are doing you should pass true for this parameter.</param>
        /// <param name="parameters">A dictionary of parameter name/value pairs.</param>
        /// <returns>The return value of the invocation.</returns>
        public object Invoke(object obj, bool mustUseAllParameters, Dictionary <string, object> parameters)
        {
            if (obj == null || parameters == null)
            {
                throw new ArgumentException("Missing or invalid argument: " + (obj == null ? "obj" : "parameters"));
            }
            string[]   names      = parameters.Keys.ToArray() ?? Constants.EmptyStringArray;
            object[]   values     = parameters.Values.ToArray() ?? Constants.EmptyObjectArray;
            Type[]     types      = values.ToTypeArray() ?? Type.EmptyTypes;
            bool       isStatic   = obj is Type;
            Type       type       = isStatic ? obj as Type : obj.GetType();
            SourceInfo sourceInfo = new SourceInfo(type, names, types);
            // check to see if we already have a map for best match
            MethodMap map = mapCache.Get(sourceInfo);

            if (map == null)
            {
                map = MapFactory.DetermineBestMethodMatch(methodPool, mustUseAllParameters, names, types, values);
                mapCache.Insert(sourceInfo, map);
            }
            return(isStatic ? map.Invoke(values) : map.Invoke(obj, values));
        }