2 // decl.cs: Declaration base class for structs, classes, enums and interfaces.
4 // Author: Miguel de Icaza (miguel@gnu.org)
5 // Marek Safar (marek.safar@seznam.cz)
7 // Dual licensed under the terms of the MIT X11 or GNU GPL
9 // Copyright 2001 Ximian, Inc (http://www.ximian.com)
10 // Copyright 2004-2008 Novell, Inc
11 // Copyright 2011 Xamarin Inc
16 using System.Collections.Generic;
17 using System.Diagnostics;
19 using Mono.CompilerServices.SymbolWriter;
22 using XmlElement = System.Object;
28 using IKVM.Reflection;
29 using IKVM.Reflection.Emit;
31 using System.Reflection;
32 using System.Reflection.Emit;
35 namespace Mono.CSharp {
38 // Better name would be DottenName
40 [DebuggerDisplay ("{GetSignatureForError()}")]
41 public class MemberName
43 public static readonly MemberName Null = new MemberName ("");
45 public readonly string Name;
46 public TypeParameters TypeParameters;
47 public readonly FullNamedExpression ExplicitInterface;
48 public readonly Location Location;
50 public readonly MemberName Left;
52 public MemberName (string name)
53 : this (name, Location.Null)
56 public MemberName (string name, Location loc)
57 : this (null, name, loc)
60 public MemberName (string name, TypeParameters tparams, Location loc)
65 this.TypeParameters = tparams;
68 public MemberName (string name, TypeParameters tparams, FullNamedExpression explicitInterface, Location loc)
69 : this (name, tparams, loc)
71 this.ExplicitInterface = explicitInterface;
74 public MemberName (MemberName left, string name, Location loc)
81 public MemberName (MemberName left, string name, FullNamedExpression explicitInterface, Location loc)
82 : this (left, name, loc)
84 this.ExplicitInterface = explicitInterface;
87 public MemberName (MemberName left, MemberName right)
89 this.Name = right.Name;
90 this.Location = right.Location;
91 this.TypeParameters = right.TypeParameters;
97 return TypeParameters == null ? 0 : TypeParameters.Count;
101 public bool IsGeneric {
103 return TypeParameters != null;
107 public string Basename {
109 if (TypeParameters != null)
110 return MakeName (Name, TypeParameters);
115 public void CreateMetadataName (StringBuilder sb)
118 Left.CreateMetadataName (sb);
120 if (sb.Length != 0) {
124 sb.Append (Basename);
127 public string GetSignatureForDocumentation ()
131 if (ExplicitInterface != null)
132 s = ExplicitInterface.GetSignatureForError () + "." + s;
137 return Left.GetSignatureForDocumentation () + "." + s;
140 public string GetSignatureForError ()
142 string s = TypeParameters == null ? null : "<" + TypeParameters.GetSignatureForError () + ">";
145 if (ExplicitInterface != null)
146 s = ExplicitInterface.GetSignatureForError () + "." + s;
151 return Left.GetSignatureForError () + "." + s;
154 public override bool Equals (object other)
156 return Equals (other as MemberName);
159 public bool Equals (MemberName other)
163 if (other == null || Name != other.Name)
166 if ((TypeParameters != null) &&
167 (other.TypeParameters == null || TypeParameters.Count != other.TypeParameters.Count))
170 if ((TypeParameters == null) && (other.TypeParameters != null))
174 return other.Left == null;
176 return Left.Equals (other.Left);
179 public override int GetHashCode ()
181 int hash = Name.GetHashCode ();
182 for (MemberName n = Left; n != null; n = n.Left)
183 hash ^= n.Name.GetHashCode ();
185 if (TypeParameters != null)
186 hash ^= TypeParameters.Count << 5;
188 return hash & 0x7FFFFFFF;
191 public static string MakeName (string name, TypeParameters args)
196 return name + "`" + args.Count;
200 public class SimpleMemberName
203 public Location Location;
205 public SimpleMemberName (string name, Location loc)
213 /// Base representation for members. This is used to keep track
214 /// of Name, Location and Modifier flags, and handling Attributes.
216 [System.Diagnostics.DebuggerDisplay ("{GetSignatureForError()}")]
217 public abstract class MemberCore : Attributable, IMemberContext, IMemberDefinition
219 string IMemberDefinition.Name {
221 return member_name.Name;
225 // Is not readonly because of IndexerName attribute
226 private MemberName member_name;
227 public MemberName MemberName {
228 get { return member_name; }
232 /// Modifier flags that the user specified in the source code
234 private Modifiers mod_flags;
235 public Modifiers ModFlags {
238 if ((value & Modifiers.COMPILER_GENERATED) != 0)
239 caching_flags = Flags.IsUsed | Flags.IsAssigned;
246 public virtual ModuleContainer Module {
248 return Parent.Module;
252 public /*readonly*/ TypeContainer Parent;
255 /// Location where this declaration happens
257 public Location Location {
258 get { return member_name.Location; }
262 /// XML documentation comment
264 protected string comment;
267 /// Represents header string for documentation comment
268 /// for each member types.
270 public abstract string DocCommentHeader { get; }
274 Obsolete_Undetected = 1, // Obsolete attribute has not been detected yet
275 Obsolete = 1 << 1, // Type has obsolete attribute
276 ClsCompliance_Undetected = 1 << 2, // CLS Compliance has not been detected yet
277 ClsCompliant = 1 << 3, // Type is CLS Compliant
278 CloseTypeCreated = 1 << 4, // Tracks whether we have Closed the type
279 HasCompliantAttribute_Undetected = 1 << 5, // Presence of CLSCompliantAttribute has not been detected
280 HasClsCompliantAttribute = 1 << 6, // Type has CLSCompliantAttribute
281 ClsCompliantAttributeFalse = 1 << 7, // Member has CLSCompliant(false)
282 Excluded_Undetected = 1 << 8, // Conditional attribute has not been detected yet
283 Excluded = 1 << 9, // Method is conditional
284 MethodOverloadsExist = 1 << 10, // Test for duplication must be performed
286 IsAssigned = 1 << 12, // Field is assigned
287 HasExplicitLayout = 1 << 13,
288 PartialDefinitionExists = 1 << 14, // Set when corresponding partial method definition exists
289 HasStructLayout = 1 << 15, // Has StructLayoutAttribute
290 HasInstanceConstructor = 1 << 16,
291 HasUserOperators = 1 << 17,
292 CanBeReused = 1 << 18,
293 InterfacesExpanded = 1 << 19,
294 HasInstanceField = 1 << 20
298 /// MemberCore flags at first detected then cached
300 internal Flags caching_flags;
302 protected MemberCore (TypeContainer parent, MemberName name, Attributes attrs)
304 this.Parent = parent;
306 caching_flags = Flags.Obsolete_Undetected | Flags.ClsCompliance_Undetected | Flags.HasCompliantAttribute_Undetected | Flags.Excluded_Undetected;
307 AddAttributes (attrs, this);
310 protected virtual void SetMemberName (MemberName new_name)
312 member_name = new_name;
315 public virtual void Accept (StructuralVisitor visitor)
317 visitor.Visit (this);
320 protected bool CheckAbstractAndExtern (bool has_block)
322 if (Parent.PartialContainer.Kind == MemberKind.Interface)
326 if ((ModFlags & Modifiers.EXTERN) != 0) {
327 Report.Error (179, Location, "`{0}' cannot declare a body because it is marked extern",
328 GetSignatureForError ());
332 if ((ModFlags & Modifiers.ABSTRACT) != 0) {
333 Report.Error (500, Location, "`{0}' cannot declare a body because it is marked abstract",
334 GetSignatureForError ());
338 if ((ModFlags & (Modifiers.ABSTRACT | Modifiers.EXTERN | Modifiers.PARTIAL)) == 0 && !(Parent is Delegate)) {
339 if (Compiler.Settings.Version >= LanguageVersion.V_3) {
340 Property.PropertyMethod pm = this as Property.PropertyMethod;
341 if (pm is Indexer.GetIndexerMethod || pm is Indexer.SetIndexerMethod)
344 if (pm != null && pm.Property.AccessorSecond == null) {
345 Report.Error (840, Location,
346 "`{0}' must have a body because it is not marked abstract or extern. The property can be automatically implemented when you define both accessors",
347 GetSignatureForError ());
352 Report.Error (501, Location, "`{0}' must have a body because it is not marked abstract, extern, or partial",
353 GetSignatureForError ());
361 protected void CheckProtectedModifier ()
363 if ((ModFlags & Modifiers.PROTECTED) == 0)
366 if (Parent.PartialContainer.Kind == MemberKind.Struct) {
367 Report.Error (666, Location, "`{0}': Structs cannot contain protected members",
368 GetSignatureForError ());
372 if ((Parent.ModFlags & Modifiers.STATIC) != 0) {
373 Report.Error (1057, Location, "`{0}': Static classes cannot contain protected members",
374 GetSignatureForError ());
378 if ((Parent.ModFlags & Modifiers.SEALED) != 0 && (ModFlags & Modifiers.OVERRIDE) == 0 &&
379 !(this is Destructor)) {
380 Report.Warning (628, 4, Location, "`{0}': new protected member declared in sealed class",
381 GetSignatureForError ());
386 public abstract bool Define ();
388 public virtual string DocComment {
398 // Returns full member name for error message
400 public virtual string GetSignatureForError ()
402 var parent = Parent.GetSignatureForError ();
404 return member_name.GetSignatureForError ();
406 return parent + "." + member_name.GetSignatureForError ();
410 /// Base Emit method. This is also entry point for CLS-Compliant verification.
412 public virtual void Emit ()
414 if (!Compiler.Settings.VerifyClsCompliance)
417 VerifyClsCompliance ();
420 public bool IsAvailableForReuse {
422 return (caching_flags & Flags.CanBeReused) != 0;
425 caching_flags = value ? (caching_flags | Flags.CanBeReused) : (caching_flags & ~Flags.CanBeReused);
429 public bool IsCompilerGenerated {
431 if ((mod_flags & Modifiers.COMPILER_GENERATED) != 0)
434 return Parent != null && Parent.IsCompilerGenerated;
438 public bool IsImported {
444 public virtual bool IsUsed {
446 return (caching_flags & Flags.IsUsed) != 0;
450 protected Report Report {
452 return Compiler.Report;
456 public void SetIsUsed ()
458 caching_flags |= Flags.IsUsed;
461 public void SetIsAssigned ()
463 caching_flags |= Flags.IsAssigned;
466 public virtual void SetConstraints (List<Constraints> constraints_list)
468 var tparams = member_name.TypeParameters;
469 if (tparams == null) {
470 Report.Error (80, Location, "Constraints are not allowed on non-generic declarations");
474 foreach (var c in constraints_list) {
475 var tp = tparams.Find (c.TypeParameter.Value);
477 Report.Error (699, c.Location, "`{0}': A constraint references nonexistent type parameter `{1}'",
478 GetSignatureForError (), c.TypeParameter.Value);
487 /// Returns instance of ObsoleteAttribute for this MemberCore
489 public virtual ObsoleteAttribute GetAttributeObsolete ()
491 if ((caching_flags & (Flags.Obsolete_Undetected | Flags.Obsolete)) == 0)
494 caching_flags &= ~Flags.Obsolete_Undetected;
496 if (OptAttributes == null)
499 Attribute obsolete_attr = OptAttributes.Search (Module.PredefinedAttributes.Obsolete);
500 if (obsolete_attr == null)
503 caching_flags |= Flags.Obsolete;
505 ObsoleteAttribute obsolete = obsolete_attr.GetObsoleteAttribute ();
506 if (obsolete == null)
513 // Checks whether the type P is as accessible as this member
515 public bool IsAccessibleAs (TypeSpec p)
518 // if M is private, its accessibility is the same as this declspace.
519 // we already know that P is accessible to T before this method, so we
522 if ((mod_flags & Modifiers.PRIVATE) != 0)
525 while (TypeManager.HasElementType (p))
526 p = TypeManager.GetElementType (p);
528 if (p.BuiltinType != BuiltinTypeSpec.Type.None)
531 if (p.IsGenericParameter)
534 for (TypeSpec p_parent; p != null; p = p_parent) {
535 p_parent = p.DeclaringType;
538 foreach (TypeSpec t in p.TypeArguments) {
539 if (!IsAccessibleAs (t))
544 var pAccess = p.Modifiers & Modifiers.AccessibilityMask;
545 if (pAccess == Modifiers.PUBLIC)
548 bool same_access_restrictions = false;
549 for (MemberCore mc = this; !same_access_restrictions && mc != null && mc.Parent != null; mc = mc.Parent) {
550 var tc = mc as TypeContainer;
551 if (tc != null && tc.PartialContainer != null)
552 mc = tc.PartialContainer;
554 var al = mc.ModFlags & Modifiers.AccessibilityMask;
556 case Modifiers.INTERNAL:
557 if (al == Modifiers.PRIVATE || al == Modifiers.INTERNAL)
558 same_access_restrictions = p.MemberDefinition.IsInternalAsPublic (mc.Module.DeclaringAssembly);
562 case Modifiers.PROTECTED:
563 if (al == Modifiers.PROTECTED) {
564 same_access_restrictions = mc.Parent.PartialContainer.IsBaseTypeDefinition (p_parent);
568 if (al == Modifiers.PRIVATE) {
570 // When type is private and any of its parents derives from
571 // protected type then the type is accessible
573 while (mc.Parent != null && mc.Parent.PartialContainer != null) {
574 if (mc.Parent.PartialContainer.IsBaseTypeDefinition (p_parent)) {
575 same_access_restrictions = true;
585 case Modifiers.PROTECTED | Modifiers.INTERNAL:
586 if (al == Modifiers.INTERNAL)
587 same_access_restrictions = p.MemberDefinition.IsInternalAsPublic (mc.Module.DeclaringAssembly);
588 else if (al == (Modifiers.PROTECTED | Modifiers.INTERNAL))
589 same_access_restrictions = mc.Parent.PartialContainer.IsBaseTypeDefinition (p_parent) && p.MemberDefinition.IsInternalAsPublic (mc.Module.DeclaringAssembly);
590 else if (al == Modifiers.PROTECTED)
591 goto case Modifiers.PROTECTED;
592 else if (al == Modifiers.PRIVATE) {
593 if (p.MemberDefinition.IsInternalAsPublic (mc.Module.DeclaringAssembly)) {
594 same_access_restrictions = true;
596 goto case Modifiers.PROTECTED;
602 case Modifiers.PRIVATE:
604 // Both are private and share same parent
606 if (al == Modifiers.PRIVATE) {
607 var decl = mc.Parent;
609 same_access_restrictions = decl.CurrentType.MemberDefinition == p_parent.MemberDefinition;
610 } while (!same_access_restrictions && !decl.PartialContainer.IsTopLevel && (decl = decl.Parent) != null);
616 throw new InternalErrorException (al.ToString ());
620 if (!same_access_restrictions)
628 /// Analyze whether CLS-Compliant verification must be execute for this MemberCore.
630 public override bool IsClsComplianceRequired ()
632 if ((caching_flags & Flags.ClsCompliance_Undetected) == 0)
633 return (caching_flags & Flags.ClsCompliant) != 0;
635 caching_flags &= ~Flags.ClsCompliance_Undetected;
637 if (HasClsCompliantAttribute) {
638 if ((caching_flags & Flags.ClsCompliantAttributeFalse) != 0)
641 caching_flags |= Flags.ClsCompliant;
645 if (Parent.IsClsComplianceRequired ()) {
646 caching_flags |= Flags.ClsCompliant;
653 public virtual string[] ConditionalConditions ()
659 /// Returns true when MemberCore is exposed from assembly.
661 public bool IsExposedFromAssembly ()
663 if ((ModFlags & (Modifiers.PUBLIC | Modifiers.PROTECTED)) == 0)
664 return this is NamespaceContainer;
666 var parentContainer = Parent.PartialContainer;
667 while (parentContainer != null) {
668 if ((parentContainer.ModFlags & (Modifiers.PUBLIC | Modifiers.PROTECTED)) == 0)
671 parentContainer = parentContainer.Parent.PartialContainer;
678 // Does extension methods look up to find a method which matches name and extensionType.
679 // Search starts from this namespace and continues hierarchically up to top level.
681 public ExtensionMethodCandidates LookupExtensionMethod (string name, int arity)
685 var ns = m as NamespaceContainer;
687 return ns.LookupExtensionMethod (this, name, arity, 0);
695 public virtual FullNamedExpression LookupNamespaceAlias (string name)
697 return Parent.LookupNamespaceAlias (name);
700 public virtual FullNamedExpression LookupNamespaceOrType (string name, int arity, LookupMode mode, Location loc)
702 return Parent.LookupNamespaceOrType (name, arity, mode, loc);
706 /// Goes through class hierarchy and gets value of first found CLSCompliantAttribute.
707 /// If no is attribute exists then assembly CLSCompliantAttribute is returned.
709 public bool? CLSAttributeValue {
711 if ((caching_flags & Flags.HasCompliantAttribute_Undetected) == 0) {
712 if ((caching_flags & Flags.HasClsCompliantAttribute) == 0)
715 return (caching_flags & Flags.ClsCompliantAttributeFalse) == 0;
718 caching_flags &= ~Flags.HasCompliantAttribute_Undetected;
720 if (OptAttributes != null) {
721 Attribute cls_attribute = OptAttributes.Search (Module.PredefinedAttributes.CLSCompliant);
722 if (cls_attribute != null) {
723 caching_flags |= Flags.HasClsCompliantAttribute;
724 if (cls_attribute.GetClsCompliantAttributeValue ())
727 caching_flags |= Flags.ClsCompliantAttributeFalse;
737 /// Returns true if MemberCore is explicitly marked with CLSCompliantAttribute
739 protected bool HasClsCompliantAttribute {
741 return CLSAttributeValue.HasValue;
746 /// Returns true when a member supports multiple overloads (methods, indexers, etc)
748 public virtual bool EnableOverloadChecks (MemberCore overload)
754 /// The main virtual method for CLS-Compliant verifications.
755 /// The method returns true if member is CLS-Compliant and false if member is not
756 /// CLS-Compliant which means that CLS-Compliant tests are not necessary. A descendants override it
757 /// and add their extra verifications.
759 protected virtual bool VerifyClsCompliance ()
761 if (HasClsCompliantAttribute) {
762 if (!Module.DeclaringAssembly.HasCLSCompliantAttribute) {
763 Attribute a = OptAttributes.Search (Module.PredefinedAttributes.CLSCompliant);
764 if ((caching_flags & Flags.ClsCompliantAttributeFalse) != 0) {
765 Report.Warning (3021, 2, a.Location,
766 "`{0}' does not need a CLSCompliant attribute because the assembly is not marked as CLS-compliant",
767 GetSignatureForError ());
769 Report.Warning (3014, 1, a.Location,
770 "`{0}' cannot be marked as CLS-compliant because the assembly is not marked as CLS-compliant",
771 GetSignatureForError ());
776 if (!IsExposedFromAssembly ()) {
777 Attribute a = OptAttributes.Search (Module.PredefinedAttributes.CLSCompliant);
778 Report.Warning (3019, 2, a.Location, "CLS compliance checking will not be performed on `{0}' because it is not visible from outside this assembly", GetSignatureForError ());
782 if ((caching_flags & Flags.ClsCompliantAttributeFalse) != 0) {
783 if (Parent is Interface && Parent.IsClsComplianceRequired ()) {
784 Report.Warning (3010, 1, Location, "`{0}': CLS-compliant interfaces must have only CLS-compliant members", GetSignatureForError ());
785 } else if (Parent.Kind == MemberKind.Class && (ModFlags & Modifiers.ABSTRACT) != 0 && Parent.IsClsComplianceRequired ()) {
786 Report.Warning (3011, 1, Location, "`{0}': only CLS-compliant members can be abstract", GetSignatureForError ());
792 if (Parent.Kind != MemberKind.Namespace && Parent.Kind != 0 && !Parent.IsClsComplianceRequired ()) {
793 Attribute a = OptAttributes.Search (Module.PredefinedAttributes.CLSCompliant);
794 Report.Warning (3018, 1, a.Location, "`{0}' cannot be marked as CLS-compliant because it is a member of non CLS-compliant type `{1}'",
795 GetSignatureForError (), Parent.GetSignatureForError ());
799 if (!IsExposedFromAssembly ())
802 if (!Parent.IsClsComplianceRequired ())
806 if (member_name.Name [0] == '_') {
807 Warning_IdentifierNotCompliant ();
810 if (member_name.TypeParameters != null)
811 member_name.TypeParameters.VerifyClsCompliance ();
816 protected void Warning_IdentifierNotCompliant ()
818 Report.Warning (3008, 1, MemberName.Location, "Identifier `{0}' is not CLS-compliant", GetSignatureForError ());
821 public virtual string GetCallerMemberName ()
823 return MemberName.Name;
827 // Returns a string that represents the signature for this
828 // member which should be used in XML documentation.
830 public abstract string GetSignatureForDocumentation ();
832 public virtual void GetCompletionStartingWith (string prefix, List<string> results)
834 Parent.GetCompletionStartingWith (prefix, results);
838 // Generates xml doc comments (if any), and if required,
839 // handle warning report.
841 internal virtual void GenerateDocComment (DocumentationBuilder builder)
843 if (DocComment == null) {
844 if (IsExposedFromAssembly ()) {
845 Constructor c = this as Constructor;
846 if (c == null || !c.IsDefault ())
847 Report.Warning (1591, 4, Location,
848 "Missing XML comment for publicly visible type or member `{0}'", GetSignatureForError ());
855 builder.GenerateDocumentationForMember (this);
856 } catch (Exception e) {
857 throw new InternalErrorException (this, e);
861 public virtual void WriteDebugSymbol (MonoSymbolFile file)
865 #region IMemberContext Members
867 public virtual CompilerContext Compiler {
869 return Module.Compiler;
873 public virtual TypeSpec CurrentType {
874 get { return Parent.CurrentType; }
877 public MemberCore CurrentMemberDefinition {
881 public virtual TypeParameters CurrentTypeParameters {
885 public bool IsObsolete {
887 if (GetAttributeObsolete () != null)
890 return Parent != null && Parent.IsObsolete;
894 public bool IsUnsafe {
896 if ((ModFlags & Modifiers.UNSAFE) != 0)
899 return Parent != null && Parent.IsUnsafe;
903 public bool IsStatic {
905 return (ModFlags & Modifiers.STATIC) != 0;
913 // Base member specification. A member specification contains
914 // member details which can alter in the context (e.g. generic instances)
916 public abstract class MemberSpec
919 public enum StateFlags
921 Obsolete_Undetected = 1, // Obsolete attribute has not been detected yet
922 Obsolete = 1 << 1, // Member has obsolete attribute
923 CLSCompliant_Undetected = 1 << 2, // CLSCompliant attribute has not been detected yet
924 CLSCompliant = 1 << 3, // Member is CLS Compliant
925 MissingDependency_Undetected = 1 << 4,
926 MissingDependency = 1 << 5,
927 HasDynamicElement = 1 << 6,
928 ConstraintsChecked = 1 << 7,
929 HasNamedTupleElement = 1 << 8,
931 IsAccessor = 1 << 9, // Method is an accessor
932 IsGeneric = 1 << 10, // Member contains type arguments
934 PendingMetaInflate = 1 << 12,
935 PendingMakeMethod = 1 << 13,
936 PendingMemberCacheMembers = 1 << 14,
937 PendingBaseTypeInflate = 1 << 15,
938 InterfacesExpanded = 1 << 16,
939 IsNotCSharpCompatible = 1 << 17,
940 SpecialRuntimeType = 1 << 18,
941 InflatedExpressionType = 1 << 19,
942 InflatedNullableType = 1 << 20,
943 GenericIterateInterface = 1 << 21,
944 GenericTask = 1 << 22,
945 InterfacesImported = 1 << 23,
950 // Some flags can be copied directly from other member
952 protected const StateFlags SharedStateFlags =
953 StateFlags.CLSCompliant | StateFlags.CLSCompliant_Undetected |
954 StateFlags.Obsolete | StateFlags.Obsolete_Undetected |
955 StateFlags.MissingDependency | StateFlags.MissingDependency_Undetected |
956 StateFlags.HasDynamicElement | StateFlags.HasNamedTupleElement;
958 protected Modifiers modifiers;
959 public StateFlags state;
960 protected IMemberDefinition definition;
961 public readonly MemberKind Kind;
962 protected TypeSpec declaringType;
966 public int ID = counter++;
969 protected MemberSpec (MemberKind kind, TypeSpec declaringType, IMemberDefinition definition, Modifiers modifiers)
972 this.declaringType = declaringType;
973 this.definition = definition;
974 this.modifiers = modifiers;
976 if (kind == MemberKind.MissingType)
977 state = StateFlags.MissingDependency;
979 state = StateFlags.Obsolete_Undetected | StateFlags.CLSCompliant_Undetected | StateFlags.MissingDependency_Undetected;
984 public virtual int Arity {
990 public TypeSpec DeclaringType {
992 return declaringType;
995 declaringType = value;
999 public IMemberDefinition MemberDefinition {
1005 public Modifiers Modifiers {
1014 public virtual string Name {
1016 return definition.Name;
1020 public bool IsAbstract {
1021 get { return (modifiers & Modifiers.ABSTRACT) != 0; }
1024 public bool IsAccessor {
1026 return (state & StateFlags.IsAccessor) != 0;
1029 state = value ? state | StateFlags.IsAccessor : state & ~StateFlags.IsAccessor;
1034 // Return true when this member is a generic in C# terms
1035 // A nested non-generic type of generic type will return false
1037 public bool IsGeneric {
1039 return (state & StateFlags.IsGeneric) != 0;
1042 state = value ? state | StateFlags.IsGeneric : state & ~StateFlags.IsGeneric;
1047 // Returns true for imported members which are not compatible with C# language
1049 public bool IsNotCSharpCompatible {
1051 return (state & StateFlags.IsNotCSharpCompatible) != 0;
1054 state = value ? state | StateFlags.IsNotCSharpCompatible : state & ~StateFlags.IsNotCSharpCompatible;
1058 public bool IsPrivate {
1059 get { return (modifiers & Modifiers.PRIVATE) != 0; }
1062 public bool IsPublic {
1063 get { return (modifiers & Modifiers.PUBLIC) != 0; }
1066 public bool IsStatic {
1068 return (modifiers & Modifiers.STATIC) != 0;
1074 public virtual void CheckObsoleteness (IMemberContext mc, Location loc)
1076 var oa = GetAttributeObsolete ();
1081 AttributeTester.Report_ObsoleteMessage (oa, GetSignatureForError (), loc, mc.Module.Compiler.Report);
1084 public virtual ObsoleteAttribute GetAttributeObsolete ()
1086 if ((state & (StateFlags.Obsolete | StateFlags.Obsolete_Undetected)) == 0)
1089 state &= ~StateFlags.Obsolete_Undetected;
1091 var oa = definition.GetAttributeObsolete ();
1093 state |= StateFlags.Obsolete;
1099 // Returns a list of missing dependencies of this member. The list
1100 // will contain types only but it can have numerous values for members
1101 // like methods where both return type and all parameters are checked
1103 public List<MissingTypeSpecReference> GetMissingDependencies ()
1105 return GetMissingDependencies (this);
1108 public List<MissingTypeSpecReference> GetMissingDependencies (MemberSpec caller)
1110 if ((state & (StateFlags.MissingDependency | StateFlags.MissingDependency_Undetected)) == 0)
1113 state &= ~StateFlags.MissingDependency_Undetected;
1115 var imported = definition as ImportedDefinition;
1116 List<MissingTypeSpecReference> missing;
1117 if (imported != null) {
1118 missing = ResolveMissingDependencies (caller);
1119 } else if (this is ElementTypeSpec) {
1120 missing = ((ElementTypeSpec) this).Element.GetMissingDependencies (caller);
1125 if (missing != null) {
1126 state |= StateFlags.MissingDependency;
1132 public abstract List<MissingTypeSpecReference> ResolveMissingDependencies (MemberSpec caller);
1134 protected virtual bool IsNotCLSCompliant (out bool attrValue)
1136 var cls = MemberDefinition.CLSAttributeValue;
1137 attrValue = cls ?? false;
1138 return cls == false;
1141 public virtual string GetSignatureForDocumentation ()
1143 return DeclaringType.GetSignatureForDocumentation () + "." + Name;
1146 public virtual string GetSignatureForError ()
1148 var bf = MemberDefinition as Property.BackingFieldDeclaration;
1153 name = bf.OriginalProperty.MemberName.Name;
1156 return DeclaringType.GetSignatureForError () + "." + name;
1159 public virtual MemberSpec InflateMember (TypeParameterInflator inflator)
1161 var inflated = (MemberSpec) MemberwiseClone ();
1162 inflated.declaringType = inflator.TypeInstance;
1163 if (DeclaringType.IsGenericOrParentIsGeneric)
1164 inflated.state |= StateFlags.PendingMetaInflate;
1166 inflated.ID += 1000000;
1172 // Is this member accessible from invocation context
1174 public bool IsAccessible (IMemberContext ctx)
1176 var ma = Modifiers & Modifiers.AccessibilityMask;
1177 if (ma == Modifiers.PUBLIC)
1180 var parentType = /* this as TypeSpec ?? */ DeclaringType;
1181 var ctype = ctx.CurrentType;
1183 if (ma == Modifiers.PRIVATE) {
1184 if (ctype == null || parentType == null)
1187 // It's only accessible to the current class or children
1189 if (parentType.MemberDefinition == ctype.MemberDefinition)
1192 return TypeManager.IsNestedChildOf (ctype, parentType.MemberDefinition);
1195 if ((ma & Modifiers.INTERNAL) != 0) {
1197 var assembly = ctype == null ? ctx.Module.DeclaringAssembly : ctype.MemberDefinition.DeclaringAssembly;
1199 if (parentType == null) {
1200 b = ((ITypeDefinition) MemberDefinition).IsInternalAsPublic (assembly);
1202 b = DeclaringType.MemberDefinition.IsInternalAsPublic (assembly);
1205 if (b || ma == Modifiers.INTERNAL)
1210 // Checks whether `ctype' is a subclass or nested child of `parentType'.
1212 while (ctype != null) {
1213 if (TypeManager.IsFamilyAccessible (ctype, parentType))
1216 // Handle nested types.
1217 ctype = ctype.DeclaringType; // TODO: Untested ???
1224 // Returns member CLS compliance based on full member hierarchy
1226 public bool IsCLSCompliant ()
1228 if ((state & StateFlags.CLSCompliant_Undetected) != 0) {
1229 state &= ~StateFlags.CLSCompliant_Undetected;
1232 if (IsNotCLSCompliant (out compliant))
1236 if (DeclaringType != null) {
1237 compliant = DeclaringType.IsCLSCompliant ();
1239 compliant = ((ITypeDefinition) MemberDefinition).DeclaringAssembly.IsCLSCompliant;
1244 state |= StateFlags.CLSCompliant;
1247 return (state & StateFlags.CLSCompliant) != 0;
1250 public bool IsConditionallyExcluded (IMemberContext ctx)
1252 if ((Kind & (MemberKind.Class | MemberKind.Method)) == 0)
1255 var conditions = MemberDefinition.ConditionalConditions ();
1256 if (conditions == null)
1259 var m = ctx.CurrentMemberDefinition;
1260 CompilationSourceFile unit = null;
1261 while (m != null && unit == null) {
1262 unit = m as CompilationSourceFile;
1267 foreach (var condition in conditions) {
1268 if (unit.IsConditionalDefined (condition))
1276 public override string ToString ()
1278 return GetSignatureForError ();
1283 // Member details which are same between all member
1286 public interface IMemberDefinition
1288 bool? CLSAttributeValue { get; }
1289 string Name { get; }
1290 bool IsImported { get; }
1292 string[] ConditionalConditions ();
1293 ObsoleteAttribute GetAttributeObsolete ();
1294 void SetIsAssigned ();
1298 public interface IMethodDefinition : IMemberDefinition
1300 MethodBase Metadata { get; }
1303 public interface IParametersMember : IInterfaceMemberSpec
1305 AParametersCollection Parameters { get; }
1308 public interface IInterfaceMemberSpec
1310 TypeSpec MemberType { get; }