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 [ClassInterfaceAttribute (ClassInterfaceType.None)]
48 [ComDefaultInterfaceAttribute (typeof (_Module))]
51 public class Module : ISerializable, ICustomAttributeProvider {
53 public static readonly TypeFilter FilterTypeName;
54 public static readonly TypeFilter FilterTypeNameIgnoreCase;
56 private IntPtr _impl; /* a pointer to a MonoImage */
57 internal Assembly assembly;
58 internal string fqname;
60 internal string scopename;
61 internal bool is_resource;
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 {
81 if (SecurityManager.SecurityEnabled) {
82 new FileIOPermission (FileIOPermissionAccess.PathDiscovery, fqname).Demand ();
88 // Note: we do not ask for PathDiscovery because no path is returned here.
89 // However MS Fx requires it (see FDBK23572 for details).
94 public string ScopeName {
95 get { return scopename; }
99 public ModuleHandle ModuleHandle {
101 return new ModuleHandle (_impl);
105 public extern int MetadataToken {
106 [MethodImplAttribute (MethodImplOptions.InternalCall)]
111 public virtual Type[] FindTypes(TypeFilter filter, object filterCriteria)
113 System.Collections.ArrayList filtered = new System.Collections.ArrayList ();
114 Type[] types = GetTypes ();
115 foreach (Type t in types)
116 if (filter (t, filterCriteria))
118 return (Type[])filtered.ToArray (typeof(Type));
121 public virtual object[] GetCustomAttributes(bool inherit)
123 return MonoCustomAttrs.GetCustomAttributes (this, inherit);
126 public virtual object[] GetCustomAttributes(Type attributeType, bool inherit)
128 return MonoCustomAttrs.GetCustomAttributes (this, attributeType, inherit);
131 public FieldInfo GetField (string name)
136 Type globalType = GetGlobalType ();
137 return (globalType != null) ? globalType.GetField (name, BindingFlags.Public | BindingFlags.Static) : null;
140 public FieldInfo GetField (string name, BindingFlags flags)
145 Type globalType = GetGlobalType ();
146 return (globalType != null) ? globalType.GetField (name, flags) : null;
149 public FieldInfo[] GetFields ()
152 return new FieldInfo [0];
154 Type globalType = GetGlobalType ();
155 return (globalType != null) ? globalType.GetFields (BindingFlags.Public | BindingFlags.Static) : new FieldInfo [0];
158 public MethodInfo GetMethod (string name)
160 return GetMethodImpl (name, defaultBindingFlags, null, CallingConventions.Any, Type.EmptyTypes, null);
163 public MethodInfo GetMethod (string name, Type[] types)
165 return GetMethodImpl (name, defaultBindingFlags, null, CallingConventions.Any, types, null);
168 public MethodInfo GetMethod (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
170 return GetMethodImpl (name, bindingAttr, binder, callConvention, types, modifiers);
173 protected virtual MethodInfo GetMethodImpl (string name, BindingFlags bindingAttr, Binder binder, CallingConventions callConvention, Type[] types, ParameterModifier[] modifiers)
178 Type globalType = GetGlobalType ();
179 return (globalType != null) ? globalType.GetMethod (name, bindingAttr, binder, callConvention, types, modifiers) : null;
182 public MethodInfo[] GetMethods ()
185 return new MethodInfo [0];
187 Type globalType = GetGlobalType ();
188 return (globalType != null) ? globalType.GetMethods () : new MethodInfo [0];
192 public MethodInfo[] GetMethods (BindingFlags flags) {
194 return new MethodInfo [0];
196 Type globalType = GetGlobalType ();
197 return (globalType != null) ? globalType.GetMethods (flags) : new MethodInfo [0];
200 public FieldInfo[] GetFields (BindingFlags flags)
203 return new FieldInfo [0];
205 Type globalType = GetGlobalType ();
206 return (globalType != null) ? globalType.GetFields (flags) : new FieldInfo [0];
210 [SecurityPermission (SecurityAction.LinkDemand, SerializationFormatter = true)]
211 public virtual void GetObjectData (SerializationInfo info, StreamingContext context)
214 throw new ArgumentNullException ("info");
216 UnitySerializationHolder.GetModuleData (this, info, context);
219 public X509Certificate GetSignerCertificate ()
222 return X509Certificate.CreateFromSignedFile (assembly.Location);
232 public virtual Type GetType(string className)
234 return GetType (className, false, false);
240 public virtual Type GetType(string className, bool ignoreCase)
242 return GetType (className, false, ignoreCase);
248 public virtual Type GetType(string className, bool throwOnError, bool ignoreCase)
250 if (className == null)
251 throw new ArgumentNullException ("className");
252 if (className == String.Empty)
253 throw new ArgumentException ("Type name can't be empty");
254 return assembly.InternalGetType (this, className, throwOnError, ignoreCase);
257 [MethodImplAttribute (MethodImplOptions.InternalCall)]
258 private extern Type[] InternalGetTypes ();
260 public virtual Type[] GetTypes()
262 return InternalGetTypes ();
265 public virtual bool IsDefined (Type attributeType, bool inherit)
267 return MonoCustomAttrs.IsDefined (this, attributeType, inherit);
270 public bool IsResource()
275 public override string ToString ()
281 [Obsolete ("Please use ModuleVersionId instead - this will be removed before Whidbey ships.")]
288 return Mono_GetGuid (this);
293 public Guid ModuleVersionId {
295 return Mono_GetGuid (this);
299 public void GetPEKind (out PortableExecutableKinds peKind, out ImageFileMachine machine) {
300 ModuleHandle.GetPEKind (out peKind, out machine);
306 private Exception resolve_token_exception (int metadataToken, ResolveTokenError error, string tokenType) {
307 if (error == ResolveTokenError.OutOfRange)
308 return new ArgumentOutOfRangeException ("metadataToken", String.Format ("Token 0x{0:x} is not valid in the scope of module {1}", metadataToken, name));
310 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");
313 [Obsolete ("Please use ResolveField(int metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments) - this will be removed before Whidbey ships.")]
314 public FieldInfo ResolveField (int metadataToken) {
315 ResolveTokenError error;
317 IntPtr handle = ResolveFieldToken (_impl, metadataToken, out error);
318 if (handle == IntPtr.Zero)
319 throw resolve_token_exception (metadataToken, error, "Field");
321 return FieldInfo.GetFieldFromHandle (new RuntimeFieldHandle (handle));
324 public MemberInfo ResolveMember (int metadataToken) {
325 ResolveTokenError error;
327 MemberInfo m = ResolveMemberToken (_impl, metadataToken, out error);
329 throw resolve_token_exception (metadataToken, error, "MemberInfo");
334 [Obsolete ("Please use ResolveMethod(int metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments) - this will be removed before Whidbey ships.")]
335 public MethodBase ResolveMethod (int metadataToken) {
336 ResolveTokenError error;
338 IntPtr handle = ResolveMethodToken (_impl, metadataToken, out error);
339 if (handle == IntPtr.Zero)
340 throw resolve_token_exception (metadataToken, error, "MethodBase");
342 return MethodBase.GetMethodFromHandle (new RuntimeMethodHandle (handle));
345 public string ResolveString (int metadataToken) {
346 ResolveTokenError error;
348 string s = ResolveStringToken (_impl, metadataToken, out error);
350 throw resolve_token_exception (metadataToken, error, "string");
355 [Obsolete ("Please use ResolveType(int metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments) - this will be removed before Whidbey ships.")]
356 public Type ResolveType (int metadataToken) {
357 ResolveTokenError error;
359 IntPtr handle = ResolveTypeToken (_impl, metadataToken, out error);
360 if (handle == IntPtr.Zero)
361 throw resolve_token_exception (metadataToken, error, "Type");
363 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
367 internal static Type MonoDebugger_ResolveType (Module module, int token)
369 ResolveTokenError error;
371 IntPtr handle = ResolveTypeToken (module._impl, token, out error);
372 if (handle == IntPtr.Zero)
375 return Type.GetTypeFromHandle (new RuntimeTypeHandle (handle));
378 // Mono Extension: returns the GUID of this module
379 internal static Guid Mono_GetGuid (Module module)
381 return new Guid (module.GetGuidInternal ());
384 private static bool filter_by_type_name (Type m, object filterCriteria) {
385 string s = (string)filterCriteria;
386 if (s.EndsWith ("*"))
387 return m.Name.StartsWith (s.Substring (0, s.Length - 1));
392 private static bool filter_by_type_name_ignore_case (Type m, object filterCriteria) {
393 string s = (string)filterCriteria;
394 if (s.EndsWith ("*"))
395 return m.Name.ToLower ().StartsWith (s.Substring (0, s.Length - 1).ToLower ());
397 return String.Compare (m.Name, s, true) == 0;
400 [MethodImplAttribute (MethodImplOptions.InternalCall)]
401 private extern string GetGuidInternal ();
403 [MethodImplAttribute (MethodImplOptions.InternalCall)]
404 private extern Type GetGlobalType ();
406 [MethodImplAttribute (MethodImplOptions.InternalCall)]
407 internal static extern IntPtr ResolveTypeToken (IntPtr module, int token, out ResolveTokenError error);
409 [MethodImplAttribute (MethodImplOptions.InternalCall)]
410 internal static extern IntPtr ResolveMethodToken (IntPtr module, int token, out ResolveTokenError error);
412 [MethodImplAttribute (MethodImplOptions.InternalCall)]
413 internal static extern IntPtr ResolveFieldToken (IntPtr module, int token, out ResolveTokenError error);
415 [MethodImplAttribute (MethodImplOptions.InternalCall)]
416 internal static extern string ResolveStringToken (IntPtr module, int token, out ResolveTokenError error);
418 [MethodImplAttribute (MethodImplOptions.InternalCall)]
419 internal static extern MemberInfo ResolveMemberToken (IntPtr module, int token, out ResolveTokenError error);
421 [MethodImplAttribute (MethodImplOptions.InternalCall)]
422 internal static extern void GetPEKind (IntPtr module, out PortableExecutableKinds peKind, out ImageFileMachine machine);