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 {
46 [ComDefaultInterfaceAttribute (typeof (_Module))]
48 [ClassInterfaceAttribute (ClassInterfaceType.None)]
49 public class Module : ISerializable, ICustomAttributeProvider, _Module {
51 public static readonly TypeFilter FilterTypeName;
52 public static readonly TypeFilter FilterTypeNameIgnoreCase;
54 #pragma warning disable 649
55 private IntPtr _impl; /* a pointer to a MonoImage */
56 internal Assembly assembly;
57 internal string fqname;
59 internal string scopename;
60 internal bool is_resource;
62 #pragma warning restore 649
64 const BindingFlags defaultBindingFlags =
65 BindingFlags.Public | BindingFlags.Static | BindingFlags.Instance;
68 FilterTypeName = new TypeFilter (filter_by_type_name);
69 FilterTypeNameIgnoreCase = new TypeFilter (filter_by_type_name_ignore_case);
75 public Assembly Assembly {
76 get { return assembly; }
79 public virtual string FullyQualifiedName {
82 if (SecurityManager.SecurityEnabled) {
83 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; }
100 public ModuleHandle ModuleHandle {
102 return new ModuleHandle (_impl);
106 public extern int MetadataToken {
107 [MethodImplAttribute (MethodImplOptions.InternalCall)]
111 public int MDStreamVersion {
113 if (_impl == IntPtr.Zero)
114 throw new NotSupportedException ();
115 return GetMDStreamVersion (_impl);
119 [MethodImplAttribute (MethodImplOptions.InternalCall)]
120 internal static extern int GetMDStreamVersion (IntPtr module_handle);
122 public virtual Type[] FindTypes(TypeFilter filter, object filterCriteria)
124 System.Collections.ArrayList filtered = new System.Collections.ArrayList ();
125 Type[] types = GetTypes ();
126 foreach (Type t in types)
127 if (filter (t, filterCriteria))
129 return (Type[])filtered.ToArray (typeof(Type));
132 public virtual object[] GetCustomAttributes(bool inherit)
134 return MonoCustomAttrs.GetCustomAttributes (this, inherit);
137 public virtual object[] GetCustomAttributes(Type attributeType, bool inherit)
139 return MonoCustomAttrs.GetCustomAttributes (this, attributeType, inherit);
142 public FieldInfo GetField (string name)
147 Type globalType = GetGlobalType ();
148 return (globalType != null) ? globalType.GetField (name, BindingFlags.Public | BindingFlags.Static) : null;
151 public FieldInfo GetField (string name, BindingFlags bindingAttr)
156 Type globalType = GetGlobalType ();
157 return (globalType != null) ? globalType.GetField (name, bindingAttr) : null;
160 public FieldInfo[] GetFields ()
163 return new FieldInfo [0];
165 Type globalType = GetGlobalType ();
166 return (globalType != null) ? globalType.GetFields (BindingFlags.Public | BindingFlags.Static) : new FieldInfo [0];
169 public MethodInfo GetMethod (string name)
171 // Can't call the other overloads since they call Type.GetMethod () which does a null check on the 'types' array
175 Type globalType = GetGlobalType ();
176 return (globalType != null) ? globalType.GetMethod (name) : null;
179 public MethodInfo GetMethod (string name, Type[] types)
181 return GetMethodImpl (name, defaultBindingFlags, null, CallingConventions.Any, types, null);
184 public MethodInfo GetMethod (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
186 return GetMethodImpl (name, bindingAttr, binder, callConvention, types, modifiers);
189 protected virtual MethodInfo GetMethodImpl (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
194 Type globalType = GetGlobalType ();
195 return (globalType != null) ? globalType.GetMethod (name, bindingAttr, binder, callConvention, types, modifiers) : null;
198 public MethodInfo[] GetMethods ()
201 return new MethodInfo [0];
203 Type globalType = GetGlobalType ();
204 return (globalType != null) ? globalType.GetMethods () : new MethodInfo [0];
207 public MethodInfo[] GetMethods (BindingFlags bindingFlags) {
209 return new MethodInfo [0];
211 Type globalType = GetGlobalType ();
212 return (globalType != null) ? globalType.GetMethods (bindingFlags) : new MethodInfo [0];
215 public FieldInfo[] GetFields (BindingFlags bindingFlags)
218 return new FieldInfo [0];
220 Type globalType = GetGlobalType ();
221 return (globalType != null) ? globalType.GetFields (bindingFlags) : new FieldInfo [0];
224 [SecurityPermission (SecurityAction.LinkDemand, SerializationFormatter = true)]
225 public virtual void GetObjectData (SerializationInfo info, StreamingContext context)
228 throw new ArgumentNullException ("info");
230 UnitySerializationHolder.GetModuleData (this, info, context);
234 public X509Certificate GetSignerCertificate ()
237 return X509Certificate.CreateFromSignedFile (assembly.Location);
246 public virtual Type GetType(string className)
248 return GetType (className, false, false);
252 public virtual Type GetType(string className, bool ignoreCase)
254 return GetType (className, false, ignoreCase);
258 public virtual Type GetType(string className, bool throwOnError, bool ignoreCase)
260 if (className == null)
261 throw new ArgumentNullException ("className");
262 if (className == String.Empty)
263 throw new ArgumentException ("Type name can't be empty");
264 return assembly.InternalGetType (this, className, throwOnError, ignoreCase);
267 [MethodImplAttribute (MethodImplOptions.InternalCall)]
268 private extern Type[] InternalGetTypes ();
270 public virtual Type[] GetTypes()
272 return InternalGetTypes ();
275 public virtual bool IsDefined (Type attributeType, bool inherit)
277 return MonoCustomAttrs.IsDefined (this, attributeType, inherit);
280 public bool IsResource()
285 public override string ToString ()
292 return GetModuleVersionId ();
296 public Guid ModuleVersionId {
298 return GetModuleVersionId ();
302 public void GetPEKind (out PortableExecutableKinds peKind, out ImageFileMachine machine) {
303 ModuleHandle.GetPEKind (out peKind, out machine);
307 private Exception resolve_token_exception (int metadataToken, ResolveTokenError error, string tokenType) {
308 if (error == ResolveTokenError.OutOfRange)
309 return new ArgumentOutOfRangeException ("metadataToken", String.Format ("Token 0x{0:x} is not valid in the scope of module {1}", metadataToken, name));
311 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");
314 private IntPtr[] ptrs_from_types (Type[] types) {
318 IntPtr[] res = new IntPtr [types.Length];
319 for (int i = 0; i < types.Length; ++i) {
320 if (types [i] == null)
321 throw new ArgumentException ();
322 res [i] = types [i].TypeHandle.Value;
328 public FieldInfo ResolveField (int metadataToken) {
329 return ResolveField (metadataToken, null, null);
332 public FieldInfo ResolveField (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
333 ResolveTokenError error;
335 IntPtr handle = ResolveFieldToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
336 if (handle == IntPtr.Zero)
337 throw resolve_token_exception (metadataToken, error, "Field");
339 return FieldInfo.GetFieldFromHandle (new RuntimeFieldHandle (handle));
342 public MemberInfo ResolveMember (int metadataToken) {
343 return ResolveMember (metadataToken, null, null);
346 public MemberInfo ResolveMember (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
348 ResolveTokenError error;
350 MemberInfo m = ResolveMemberToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
352 throw resolve_token_exception (metadataToken, error, "MemberInfo");
357 public MethodBase ResolveMethod (int metadataToken) {
358 return ResolveMethod (metadataToken, null, null);
361 public MethodBase ResolveMethod (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
362 ResolveTokenError error;
364 IntPtr handle = ResolveMethodToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
365 if (handle == IntPtr.Zero)
366 throw resolve_token_exception (metadataToken, error, "MethodBase");
368 return MethodBase.GetMethodFromHandleNoGenericCheck (new RuntimeMethodHandle (handle));
371 public string ResolveString (int metadataToken) {
372 ResolveTokenError error;
374 string s = ResolveStringToken (_impl, metadataToken, out error);
376 throw resolve_token_exception (metadataToken, error, "string");
381 public Type ResolveType (int metadataToken) {
382 return ResolveType (metadataToken, null, null);
385 public Type ResolveType (int metadataToken, Type [] genericTypeArguments, Type [] genericMethodArguments) {
386 ResolveTokenError error;
388 IntPtr handle = ResolveTypeToken (_impl, metadataToken, ptrs_from_types (genericTypeArguments), ptrs_from_types (genericMethodArguments), out error);
389 if (handle == IntPtr.Zero)
390 throw resolve_token_exception (metadataToken, error, "Type");
392 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
395 public byte[] ResolveSignature (int metadataToken) {
396 ResolveTokenError error;
398 byte[] res = ResolveSignature (_impl, metadataToken, out error);
400 throw resolve_token_exception (metadataToken, error, "signature");
405 internal static Type MonoDebugger_ResolveType (Module module, int token)
407 ResolveTokenError error;
409 IntPtr handle = ResolveTypeToken (module._impl, token, null, null, out error);
410 if (handle == IntPtr.Zero)
413 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
416 // Used by mcs, the symbol writer, and mdb through reflection
417 internal static Guid Mono_GetGuid (Module module)
419 return module.GetModuleVersionId ();
422 internal virtual Guid GetModuleVersionId ()
424 return new Guid (GetGuidInternal ());
427 private static bool filter_by_type_name (Type m, object filterCriteria) {
428 string s = (string)filterCriteria;
429 if (s.EndsWith ("*"))
430 return m.Name.StartsWith (s.Substring (0, s.Length - 1));
435 private static bool filter_by_type_name_ignore_case (Type m, object filterCriteria) {
436 string s = (string)filterCriteria;
437 if (s.EndsWith ("*"))
438 return m.Name.ToLower ().StartsWith (s.Substring (0, s.Length - 1).ToLower ());
440 return String.Compare (m.Name, s, true) == 0;
443 [MethodImplAttribute (MethodImplOptions.InternalCall)]
444 internal extern IntPtr GetHINSTANCE ();
446 [MethodImplAttribute (MethodImplOptions.InternalCall)]
447 private extern string GetGuidInternal ();
449 [MethodImplAttribute (MethodImplOptions.InternalCall)]
450 private extern Type GetGlobalType ();
452 [MethodImplAttribute (MethodImplOptions.InternalCall)]
453 internal static extern IntPtr ResolveTypeToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
455 [MethodImplAttribute (MethodImplOptions.InternalCall)]
456 internal static extern IntPtr ResolveMethodToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
458 [MethodImplAttribute (MethodImplOptions.InternalCall)]
459 internal static extern IntPtr ResolveFieldToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
461 [MethodImplAttribute (MethodImplOptions.InternalCall)]
462 internal static extern string ResolveStringToken (IntPtr module, int token, out ResolveTokenError error);
464 [MethodImplAttribute (MethodImplOptions.InternalCall)]
465 internal static extern MemberInfo ResolveMemberToken (IntPtr module, int token, IntPtr[] type_args, IntPtr[] method_args, out ResolveTokenError error);
467 [MethodImplAttribute (MethodImplOptions.InternalCall)]
468 internal static extern byte[] ResolveSignature (IntPtr module, int metadataToken, out ResolveTokenError error);
470 [MethodImplAttribute (MethodImplOptions.InternalCall)]
471 internal static extern void GetPEKind (IntPtr module, out PortableExecutableKinds peKind, out ImageFileMachine machine);
473 void _Module.GetIDsOfNames ([In] ref Guid riid, IntPtr rgszNames, uint cNames, uint lcid, IntPtr rgDispId)
475 throw new NotImplementedException ();
478 void _Module.GetTypeInfo (uint iTInfo, uint lcid, IntPtr ppTInfo)
480 throw new NotImplementedException ();
483 void _Module.GetTypeInfoCount (out uint pcTInfo)
485 throw new NotImplementedException ();
488 void _Module.Invoke (uint dispIdMember, [In] ref Guid riid, uint lcid, short wFlags, IntPtr pDispParams,
489 IntPtr pVarResult, IntPtr pExcepInfo, IntPtr puArgErr)
491 throw new NotImplementedException ();