2 // System.Reflection/Module.cs
5 // Paolo Molaro (lupus@ximian.com)
7 // (C) 2001 Ximian, Inc. http://www.ximian.com
8 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
10 // Permission is hereby granted, free of charge, to any person obtaining
11 // a copy of this software and associated documentation files (the
12 // "Software"), to deal in the Software without restriction, including
13 // without limitation the rights to use, copy, modify, merge, publish,
14 // distribute, sublicense, and/or sell copies of the Software, and to
15 // permit persons to whom the Software is furnished to do so, subject to
16 // the following conditions:
18 // The above copyright notice and this permission notice shall be
19 // included in all copies or substantial portions of the Software.
21 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
23 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
25 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
26 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
27 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 using System.Runtime.Serialization;
31 using System.Security.Cryptography.X509Certificates;
32 using System.Runtime.InteropServices;
33 using System.Runtime.CompilerServices;
34 using System.Security;
35 using System.Security.Permissions;
37 namespace System.Reflection {
39 internal enum ResolveTokenError {
47 [ComDefaultInterfaceAttribute (typeof (_Module))]
50 [ClassInterfaceAttribute (ClassInterfaceType.None)]
51 public class Module : ISerializable, ICustomAttributeProvider, _Module {
53 public static readonly TypeFilter FilterTypeName;
54 public static readonly TypeFilter FilterTypeNameIgnoreCase;
56 #pragma warning disable 649
57 private IntPtr _impl; /* a pointer to a MonoImage */
58 internal Assembly assembly;
59 internal string fqname;
61 internal string scopename;
62 internal bool is_resource;
64 #pragma warning restore 649
66 const BindingFlags defaultBindingFlags =
67 BindingFlags.Public | BindingFlags.Static | BindingFlags.Instance;
70 FilterTypeName = new TypeFilter (filter_by_type_name);
71 FilterTypeNameIgnoreCase = new TypeFilter (filter_by_type_name_ignore_case);
77 public Assembly Assembly {
78 get { return assembly; }
81 public virtual string FullyQualifiedName {
83 if (SecurityManager.SecurityEnabled) {
84 new FileIOPermission (FileIOPermissionAccess.PathDiscovery, fqname).Demand ();
90 // Note: we do not ask for PathDiscovery because no path is returned here.
91 // However MS Fx requires it (see FDBK23572 for details).
96 public string ScopeName {
97 get { return scopename; }
101 public ModuleHandle ModuleHandle {
103 return new ModuleHandle (_impl);
107 public extern int MetadataToken {
108 [MethodImplAttribute (MethodImplOptions.InternalCall)]
112 public int MDStreamVersion {
114 if (_impl == IntPtr.Zero)
115 throw new NotSupportedException ();
116 return GetMDStreamVersion (_impl);
120 [MethodImplAttribute (MethodImplOptions.InternalCall)]
121 internal static extern int GetMDStreamVersion (IntPtr module_handle);
124 public virtual Type[] FindTypes(TypeFilter filter, object filterCriteria)
126 System.Collections.ArrayList filtered = new System.Collections.ArrayList ();
127 Type[] types = GetTypes ();
128 foreach (Type t in types)
129 if (filter (t, filterCriteria))
131 return (Type[])filtered.ToArray (typeof(Type));
134 public virtual object[] GetCustomAttributes(bool inherit)
136 return MonoCustomAttrs.GetCustomAttributes (this, inherit);
139 public virtual object[] GetCustomAttributes(Type attributeType, bool inherit)
141 return MonoCustomAttrs.GetCustomAttributes (this, attributeType, inherit);
144 public FieldInfo GetField (string name)
149 Type globalType = GetGlobalType ();
150 return (globalType != null) ? globalType.GetField (name, BindingFlags.Public | BindingFlags.Static) : null;
153 public FieldInfo GetField (string name, BindingFlags bindingAttr)
158 Type globalType = GetGlobalType ();
159 return (globalType != null) ? globalType.GetField (name, bindingAttr) : null;
162 public FieldInfo[] GetFields ()
165 return new FieldInfo [0];
167 Type globalType = GetGlobalType ();
168 return (globalType != null) ? globalType.GetFields (BindingFlags.Public | BindingFlags.Static) : new FieldInfo [0];
171 public MethodInfo GetMethod (string name)
173 // Can't call the other overloads since they call Type.GetMethod () which does a null check on the 'types' array
177 Type globalType = GetGlobalType ();
178 return (globalType != null) ? globalType.GetMethod (name) : null;
181 public MethodInfo GetMethod (string name, Type[] types)
183 return GetMethodImpl (name, defaultBindingFlags, null, CallingConventions.Any, types, null);
186 public MethodInfo GetMethod (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
188 return GetMethodImpl (name, bindingAttr, binder, callConvention, types, modifiers);
191 protected virtual MethodInfo GetMethodImpl (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
196 Type globalType = GetGlobalType ();
197 return (globalType != null) ? globalType.GetMethod (name, bindingAttr, binder, callConvention, types, modifiers) : null;
200 public MethodInfo[] GetMethods ()
203 return new MethodInfo [0];
205 Type globalType = GetGlobalType ();
206 return (globalType != null) ? globalType.GetMethods () : new MethodInfo [0];
210 public MethodInfo[] GetMethods (BindingFlags bindingFlags) {
212 return new MethodInfo [0];
214 Type globalType = GetGlobalType ();
215 return (globalType != null) ? globalType.GetMethods (bindingFlags) : new MethodInfo [0];
218 public FieldInfo[] GetFields (BindingFlags bindingFlags)
221 return new FieldInfo [0];
223 Type globalType = GetGlobalType ();
224 return (globalType != null) ? globalType.GetFields (bindingFlags) : new FieldInfo [0];
228 [SecurityPermission (SecurityAction.LinkDemand, SerializationFormatter = true)]
229 public virtual void GetObjectData (SerializationInfo info, StreamingContext context)
232 throw new ArgumentNullException ("info");
234 UnitySerializationHolder.GetModuleData (this, info, context);
237 public X509Certificate GetSignerCertificate ()
240 return X509Certificate.CreateFromSignedFile (assembly.Location);
250 public virtual Type GetType(string className)
252 return GetType (className, false, false);
258 public virtual Type GetType(string className, bool ignoreCase)
260 return GetType (className, false, ignoreCase);
266 public virtual Type GetType(string className, bool throwOnError, bool ignoreCase)
268 if (className == null)
269 throw new ArgumentNullException ("className");
270 if (className == String.Empty)
271 throw new ArgumentException ("Type name can't be empty");
272 return assembly.InternalGetType (this, className, throwOnError, ignoreCase);
275 [MethodImplAttribute (MethodImplOptions.InternalCall)]
276 private extern Type[] InternalGetTypes ();
278 public virtual Type[] GetTypes()
280 return InternalGetTypes ();
283 public virtual bool IsDefined (Type attributeType, bool inherit)
285 return MonoCustomAttrs.IsDefined (this, attributeType, inherit);
288 public bool IsResource()
293 public override string ToString ()
300 return Mono_GetGuid (this);
305 public Guid ModuleVersionId {
307 return Mono_GetGuid (this);
311 public void GetPEKind (out PortableExecutableKinds peKind, out ImageFileMachine machine) {
312 ModuleHandle.GetPEKind (out peKind, out machine);
318 private Exception resolve_token_exception (int metadataToken, ResolveTokenError error, string tokenType) {
319 if (error == ResolveTokenError.OutOfRange)
320 return new ArgumentOutOfRangeException ("metadataToken", String.Format ("Token 0x{0:x} is not valid in the scope of module {1}", metadataToken, name));
322 return new ArgumentException (String.Format ("Token 0x{0:x} is not a valid {1} token in the scope of module {2}", metadataToken, tokenType, name), "metadataToken");
325 private IntPtr[] ptrs_from_types (Type[] types) {
329 IntPtr[] res = new IntPtr [types.Length];
330 for (int i = 0; i < types.Length; ++i) {
331 if (types [i] == null)
332 throw new ArgumentException ();
333 res [i] = types [i].TypeHandle.Value;
339 public FieldInfo ResolveField (int metadataToken) {
340 return ResolveField (metadataToken, null, null);
343 public FieldInfo ResolveField (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
344 ResolveTokenError error;
346 IntPtr handle = ResolveFieldToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
347 if (handle == IntPtr.Zero)
348 throw resolve_token_exception (metadataToken, error, "Field");
350 return FieldInfo.GetFieldFromHandle (new RuntimeFieldHandle (handle));
353 public MemberInfo ResolveMember (int metadataToken) {
354 return ResolveMember (metadataToken, null, null);
357 public MemberInfo ResolveMember (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
359 ResolveTokenError error;
361 MemberInfo m = ResolveMemberToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
363 throw resolve_token_exception (metadataToken, error, "MemberInfo");
368 public MethodBase ResolveMethod (int metadataToken) {
369 return ResolveMethod (metadataToken, null, null);
372 public MethodBase ResolveMethod (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
373 ResolveTokenError error;
375 IntPtr handle = ResolveMethodToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
376 if (handle == IntPtr.Zero)
377 throw resolve_token_exception (metadataToken, error, "MethodBase");
379 return MethodBase.GetMethodFromHandle (new RuntimeMethodHandle (handle));
382 public string ResolveString (int metadataToken) {
383 ResolveTokenError error;
385 string s = ResolveStringToken (_impl, metadataToken, out error);
387 throw resolve_token_exception (metadataToken, error, "string");
392 public Type ResolveType (int metadataToken) {
393 return ResolveType (metadataToken, null, null);
396 public Type ResolveType (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
397 ResolveTokenError error;
399 IntPtr handle = ResolveTypeToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
400 if (handle == IntPtr.Zero)
401 throw resolve_token_exception (metadataToken, error, "Type");
403 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
406 public byte[] ResolveSignature (int metadataToken) {
407 ResolveTokenError error;
409 byte[] res = ResolveSignature (_impl, metadataToken, out error);
411 throw resolve_token_exception (metadataToken, error, "signature");
417 internal static Type MonoDebugger_ResolveType (Module module, int token)
419 ResolveTokenError error;
421 IntPtr handle = ResolveTypeToken (module._impl, token, null, null, out error);
422 if (handle == IntPtr.Zero)
425 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
428 // Mono Extension: returns the GUID of this module
429 internal static Guid Mono_GetGuid (Module module)
431 return new Guid (module.GetGuidInternal ());
434 private static bool filter_by_type_name (Type m, object filterCriteria) {
435 string s = (string)filterCriteria;
436 if (s.EndsWith ("*"))
437 return m.Name.StartsWith (s.Substring (0, s.Length - 1));
442 private static bool filter_by_type_name_ignore_case (Type m, object filterCriteria) {
443 string s = (string)filterCriteria;
444 if (s.EndsWith ("*"))
445 return m.Name.ToLower ().StartsWith (s.Substring (0, s.Length - 1).ToLower ());
447 return String.Compare (m.Name, s, true) == 0;
450 [MethodImplAttribute (MethodImplOptions.InternalCall)]
451 internal extern IntPtr GetHINSTANCE ();
453 [MethodImplAttribute (MethodImplOptions.InternalCall)]
454 private extern string GetGuidInternal ();
456 [MethodImplAttribute (MethodImplOptions.InternalCall)]
457 private extern Type GetGlobalType ();
459 [MethodImplAttribute (MethodImplOptions.InternalCall)]
460 internal static extern IntPtr ResolveTypeToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
462 [MethodImplAttribute (MethodImplOptions.InternalCall)]
463 internal static extern IntPtr ResolveMethodToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
465 [MethodImplAttribute (MethodImplOptions.InternalCall)]
466 internal static extern IntPtr ResolveFieldToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
468 [MethodImplAttribute (MethodImplOptions.InternalCall)]
469 internal static extern string ResolveStringToken (IntPtr module, int token, out ResolveTokenError error);
471 [MethodImplAttribute (MethodImplOptions.InternalCall)]
472 internal static extern MemberInfo ResolveMemberToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
474 [MethodImplAttribute (MethodImplOptions.InternalCall)]
475 internal static extern byte[] ResolveSignature (IntPtr module, int metadataToken, out ResolveTokenError error);
477 [MethodImplAttribute (MethodImplOptions.InternalCall)]
478 internal static extern void GetPEKind (IntPtr module, out PortableExecutableKinds peKind, out ImageFileMachine machine);
481 void _Module.GetIDsOfNames ([In] ref Guid riid, IntPtr rgszNames, uint cNames, uint lcid, IntPtr rgDispId)
483 throw new NotImplementedException ();
486 void _Module.GetTypeInfo (uint iTInfo, uint lcid, IntPtr ppTInfo)
488 throw new NotImplementedException ();
491 void _Module.GetTypeInfoCount (out uint pcTInfo)
493 throw new NotImplementedException ();
496 void _Module.Invoke (uint dispIdMember, [In] ref Guid riid, uint lcid, short wFlags, IntPtr pDispParams,
497 IntPtr pVarResult, IntPtr pExcepInfo, IntPtr puArgErr)
499 throw new NotImplementedException ();