/// <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));
}