2 // method.cs: Method based declarations
4 // Authors: Miguel de Icaza (miguel@gnu.org)
5 // Martin Baulig (martin@ximian.com)
6 // Marek Safar (marek.safar@gmail.com)
8 // Dual licensed under the terms of the MIT X11 or GNU GPL
10 // Copyright 2001, 2002, 2003 Ximian, Inc (http://www.ximian.com)
11 // Copyright 2004-2008 Novell, Inc
15 using System.Collections.Generic;
16 using System.Reflection;
17 using System.Reflection.Emit;
18 using System.Runtime.CompilerServices;
19 using System.Runtime.InteropServices;
20 using System.Security;
21 using System.Security.Permissions;
26 using XmlElement = System.Object;
31 using Mono.CompilerServices.SymbolWriter;
33 namespace Mono.CSharp {
35 public abstract class MethodCore : InterfaceMemberBase, IParametersMember
37 protected ParametersCompiled parameters;
38 protected ToplevelBlock block;
39 protected MethodSpec spec;
41 public MethodCore (DeclSpace parent, GenericMethod generic,
42 FullNamedExpression type, Modifiers mod, Modifiers allowed_mod,
43 MemberName name, Attributes attrs, ParametersCompiled parameters)
44 : base (parent, generic, type, mod, allowed_mod, name, attrs)
46 this.parameters = parameters;
50 // Returns the System.Type array for the parameters of this method
52 public TypeSpec [] ParameterTypes {
54 return parameters.Types;
58 public ParametersCompiled ParameterInfo {
64 AParametersCollection IParametersMember.Parameters {
65 get { return parameters; }
68 public ToplevelBlock Block {
78 public CallingConventions CallingConventions {
80 CallingConventions cc = parameters.CallingConvention;
82 if ((ModFlags & Modifiers.STATIC) == 0)
83 cc |= CallingConventions.HasThis;
85 // FIXME: How is `ExplicitThis' used in C#?
91 protected override bool CheckOverrideAgainstBase (MemberSpec base_member)
93 bool res = base.CheckOverrideAgainstBase (base_member);
96 // Check that the permissions are not being changed
98 if (!CheckAccessModifiers (this, base_member)) {
99 Error_CannotChangeAccessModifiers (this, base_member);
106 protected override bool CheckBase ()
108 // Check whether arguments were correct.
109 if (!DefineParameters (parameters))
112 return base.CheckBase ();
116 // Returns a string that represents the signature for this
117 // member which should be used in XML documentation.
119 public override string GetDocCommentName (DeclSpace ds)
121 return DocUtil.GetMethodDocCommentName (this, parameters, ds);
125 // Raised (and passed an XmlElement that contains the comment)
126 // when GenerateDocComment is writing documentation expectedly.
128 // FIXME: with a few effort, it could be done with XmlReader,
129 // that means removal of DOM use.
131 internal override void OnGenerateDocComment (XmlElement el)
133 DocUtil.OnMethodGenerateDocComment (this, el, Report);
137 // Represents header string for documentation comment.
139 public override string DocCommentHeader
144 public override bool EnableOverloadChecks (MemberCore overload)
146 if (overload is MethodCore || overload is AbstractPropertyEventMethod) {
147 caching_flags |= Flags.MethodOverloadsExist;
151 return base.EnableOverloadChecks (overload);
154 public MethodSpec Spec {
158 protected override bool VerifyClsCompliance ()
160 if (!base.VerifyClsCompliance ())
163 if (parameters.HasArglist) {
164 Report.Warning (3000, 1, Location, "Methods with variable arguments are not CLS-compliant");
167 if (member_type != null && !member_type.IsCLSCompliant ()) {
168 Report.Warning (3002, 1, Location, "Return type of `{0}' is not CLS-compliant",
169 GetSignatureForError ());
172 parameters.VerifyClsCompliance (this);
177 public interface IGenericMethodDefinition : IMemberDefinition
179 TypeParameterSpec[] TypeParameters { get; }
180 int TypeParametersCount { get; }
182 // MethodInfo MakeGenericMethod (TypeSpec[] targs);
185 public class MethodSpec : MemberSpec, IParametersMember
188 AParametersCollection parameters;
192 TypeParameterSpec[] constraints;
194 public MethodSpec (MemberKind kind, TypeSpec declaringType, IMemberDefinition details, TypeSpec returnType,
195 MethodBase info, AParametersCollection parameters, Modifiers modifiers)
196 : base (kind, declaringType, details, modifiers)
198 this.metaInfo = info;
199 this.parameters = parameters;
200 this.returnType = returnType;
205 public override int Arity {
207 return IsGeneric ? GenericDefinition.TypeParametersCount : 0;
211 public TypeParameterSpec[] Constraints {
213 if (constraints == null && IsGeneric)
214 constraints = GenericDefinition.TypeParameters;
220 public bool IsConstructor {
222 return Kind == MemberKind.Constructor;
226 public IGenericMethodDefinition GenericDefinition {
228 return (IGenericMethodDefinition) definition;
232 public bool IsExtensionMethod {
234 return IsStatic && parameters.HasExtensionMethodType;
238 public bool IsSealed {
240 return (Modifiers & Modifiers.SEALED) != 0;
244 // When is virtual or abstract
245 public bool IsVirtual {
247 return (Modifiers & (Modifiers.VIRTUAL | Modifiers.ABSTRACT | Modifiers.OVERRIDE)) != 0;
251 public bool IsReservedMethod {
253 return Kind == MemberKind.Operator || IsAccessor;
257 TypeSpec IInterfaceMemberSpec.MemberType {
263 public AParametersCollection Parameters {
269 public TypeSpec ReturnType {
275 public TypeSpec[] TypeArguments {
283 public MethodSpec GetGenericMethodDefinition ()
285 if (!IsGeneric && !DeclaringType.IsGeneric)
288 return MemberCache.GetMember (declaringType, this);
291 public MethodBase GetMetaInfo ()
293 if ((state & StateFlags.PendingMetaInflate) != 0) {
294 if (DeclaringType.IsTypeBuilder) {
296 metaInfo = TypeBuilder.GetConstructor (DeclaringType.GetMetaInfo (), (ConstructorInfo) metaInfo);
298 metaInfo = TypeBuilder.GetMethod (DeclaringType.GetMetaInfo (), (MethodInfo) metaInfo);
300 metaInfo = MethodInfo.GetMethodFromHandle (metaInfo.MethodHandle, DeclaringType.GetMetaInfo ().TypeHandle);
303 state &= ~StateFlags.PendingMetaInflate;
306 if ((state & StateFlags.PendingMakeMethod) != 0) {
307 metaInfo = ((MethodInfo) metaInfo).MakeGenericMethod (targs.Select (l => l.GetMetaInfo ()).ToArray ());
308 state &= ~StateFlags.PendingMakeMethod;
311 if (Kind == MemberKind.FakeMethod)
312 throw new InternalErrorException ("Emitting fake method");
317 public override string GetSignatureForError ()
321 name = DeclaringType.GetSignatureForError () + "." + DeclaringType.Name;
322 } else if (Kind == MemberKind.Operator) {
323 var op = Operator.GetType (Name).Value;
324 if (op == Operator.OpType.Implicit || op == Operator.OpType.Explicit) {
325 name = DeclaringType.GetSignatureForError () + "." + Operator.GetName (op) + " operator " + returnType.GetSignatureForError ();
327 name = DeclaringType.GetSignatureForError () + ".operator " + Operator.GetName (op);
329 } else if (IsAccessor) {
330 int split = Name.IndexOf ('_');
331 name = Name.Substring (split + 1);
332 var postfix = Name.Substring (0, split);
334 var pc = parameters.Count;
335 if (pc > 0 && postfix == "get") {
336 name = "this" + parameters.GetSignatureForError ("[", "]", pc);
337 } else if (pc > 1 && postfix == "set") {
338 name = "this" + parameters.GetSignatureForError ("[", "]", pc - 1);
342 return DeclaringType.GetSignatureForError () + "." + name + "." + postfix;
344 name = base.GetSignatureForError ();
346 name += "<" + TypeManager.CSharpName (targs) + ">";
348 name += "<" + TypeManager.CSharpName (GenericDefinition.TypeParameters) + ">";
351 return name + parameters.GetSignatureForError ();
354 public override MemberSpec InflateMember (TypeParameterInflator inflator)
356 var ms = (MethodSpec) base.InflateMember (inflator);
357 ms.returnType = inflator.Inflate (returnType);
358 ms.parameters = parameters.Inflate (inflator);
360 ms.constraints = TypeParameterSpec.InflateConstraints (inflator, GenericDefinition.TypeParameters);
365 public MethodSpec MakeGenericMethod (params TypeSpec[] targs)
368 throw new ArgumentNullException ();
370 // if (generic_intances != null && generic_intances.TryGetValue (targs, out ginstance))
373 //if (generic_intances == null)
374 // generic_intances = new Dictionary<TypeSpec[], Method> (TypeSpecArrayComparer.Default);
376 var inflator = new TypeParameterInflator (DeclaringType, GenericDefinition.TypeParameters, targs);
378 var inflated = (MethodSpec) MemberwiseClone ();
379 inflated.declaringType = inflator.TypeInstance;
380 inflated.returnType = inflator.Inflate (returnType);
381 inflated.parameters = parameters.Inflate (inflator);
382 inflated.targs = targs;
383 inflated.constraints = TypeParameterSpec.InflateConstraints (inflator, constraints ?? GenericDefinition.TypeParameters);
384 inflated.state |= StateFlags.PendingMakeMethod;
386 // if (inflated.parent == null)
387 // inflated.parent = parent;
389 //generic_intances.Add (targs, inflated);
393 public MethodSpec Mutate (TypeParameterMutator mutator)
395 var targs = TypeArguments;
397 targs = mutator.Mutate (targs);
399 var decl = DeclaringType;
400 if (DeclaringType.IsGenericOrParentIsGeneric) {
401 decl = mutator.Mutate (decl);
404 if (targs == TypeArguments && decl == DeclaringType)
407 var ms = (MethodSpec) MemberwiseClone ();
408 if (decl != DeclaringType) {
409 // Gets back MethodInfo in case of metaInfo was inflated
410 ms.metaInfo = MemberCache.GetMember (DeclaringType.GetDefinition (), this).metaInfo;
412 ms.declaringType = decl;
413 ms.state |= StateFlags.PendingMetaInflate;
418 ms.state |= StateFlags.PendingMakeMethod;
424 public void SetMetaInfo (MethodInfo info)
426 if (this.metaInfo != null)
427 throw new InternalErrorException ("MetaInfo reset");
429 this.metaInfo = info;
433 public abstract class MethodOrOperator : MethodCore, IMethodData
435 public MethodBuilder MethodBuilder;
436 ReturnParameter return_attributes;
437 Dictionary<SecurityAction, PermissionSet> declarative_security;
438 protected MethodData MethodData;
440 static string[] attribute_targets = new string [] { "method", "return" };
442 protected MethodOrOperator (DeclSpace parent, GenericMethod generic, FullNamedExpression type, Modifiers mod,
443 Modifiers allowed_mod, MemberName name,
444 Attributes attrs, ParametersCompiled parameters)
445 : base (parent, generic, type, mod, allowed_mod, name,
450 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
452 if (a.Target == AttributeTargets.ReturnValue) {
453 if (return_attributes == null)
454 return_attributes = new ReturnParameter (this, MethodBuilder, Location);
456 return_attributes.ApplyAttributeBuilder (a, ctor, cdata, pa);
460 if (a.IsInternalMethodImplAttribute) {
461 is_external_implementation = true;
464 if (a.Type == pa.DllImport) {
465 const Modifiers extern_static = Modifiers.EXTERN | Modifiers.STATIC;
466 if ((ModFlags & extern_static) != extern_static) {
467 Report.Error (601, a.Location, "The DllImport attribute must be specified on a method marked `static' and `extern'");
469 is_external_implementation = true;
472 if (a.IsValidSecurityAttribute ()) {
473 if (declarative_security == null)
474 declarative_security = new Dictionary<SecurityAction, PermissionSet> ();
475 a.ExtractSecurityPermissionSet (declarative_security);
479 if (MethodBuilder != null)
480 MethodBuilder.SetCustomAttribute ((ConstructorInfo) ctor.GetMetaInfo (), cdata);
483 public override AttributeTargets AttributeTargets {
485 return AttributeTargets.Method;
489 protected override bool CheckForDuplications ()
491 return Parent.MemberCache.CheckExistingMembersOverloads (this, parameters);
494 public virtual EmitContext CreateEmitContext (ILGenerator ig)
496 return new EmitContext (this, ig, MemberType);
499 public override bool Define ()
508 if (this is Operator)
509 kind = MemberKind.Operator;
510 else if (this is Destructor)
511 kind = MemberKind.Destructor;
513 kind = MemberKind.Method;
515 if (IsPartialDefinition) {
516 caching_flags &= ~Flags.Excluded_Undetected;
517 caching_flags |= Flags.Excluded;
519 // Add to member cache only when a partial method implementation has not been found yet
520 if ((caching_flags & Flags.PartialDefinitionExists) == 0) {
521 // MethodBase mb = new PartialMethodDefinitionInfo (this);
523 spec = new MethodSpec (kind, Parent.Definition, this, ReturnType, null, parameters, ModFlags);
524 Parent.MemberCache.AddMember (spec);
530 MethodData = new MethodData (
531 this, ModFlags, flags, this, MethodBuilder, GenericMethod, base_method);
533 if (!MethodData.Define (Parent.PartialContainer, GetFullName (MemberName), Report))
536 MethodBuilder = MethodData.MethodBuilder;
538 spec = new MethodSpec (kind, Parent.Definition, this, ReturnType, MethodBuilder, parameters, ModFlags);
539 if (MemberName.Arity > 0)
540 spec.IsGeneric = true;
542 Parent.MemberCache.AddMember (this, MethodBuilder.Name, spec);
547 protected override void DoMemberTypeIndependentChecks ()
549 base.DoMemberTypeIndependentChecks ();
551 CheckAbstractAndExtern (block != null);
553 if ((ModFlags & Modifiers.PARTIAL) != 0) {
554 for (int i = 0; i < parameters.Count; ++i) {
555 IParameterData p = parameters.FixedParameters [i];
556 if (p.ModFlags == Parameter.Modifier.OUT) {
557 Report.Error (752, Location, "`{0}': A partial method parameters cannot use `out' modifier",
558 GetSignatureForError ());
561 if (p.HasDefaultValue && IsPartialImplementation)
562 ((Parameter) p).Warning_UselessOptionalParameter (Report);
567 protected override void DoMemberTypeDependentChecks ()
569 base.DoMemberTypeDependentChecks ();
571 if (MemberType.IsStatic) {
572 Error_StaticReturnType ();
576 public override void Emit ()
578 if ((ModFlags & Modifiers.COMPILER_GENERATED) != 0 && !Parent.IsCompilerGenerated)
579 PredefinedAttributes.Get.CompilerGenerated.EmitAttribute (MethodBuilder);
580 if ((ModFlags & Modifiers.DEBUGGER_HIDDEN) != 0)
581 PredefinedAttributes.Get.DebuggerHidden.EmitAttribute (MethodBuilder);
583 if (ReturnType == InternalType.Dynamic) {
584 return_attributes = new ReturnParameter (this, MethodBuilder, Location);
585 PredefinedAttributes.Get.Dynamic.EmitAttribute (return_attributes.Builder);
587 var trans_flags = TypeManager.HasDynamicTypeUsed (ReturnType);
588 if (trans_flags != null) {
589 var pa = PredefinedAttributes.Get.DynamicTransform;
590 if (pa.Constructor != null || pa.ResolveConstructor (Location, ArrayContainer.MakeType (TypeManager.bool_type))) {
591 return_attributes = new ReturnParameter (this, MethodBuilder, Location);
592 return_attributes.Builder.SetCustomAttribute (
593 new CustomAttributeBuilder (pa.Constructor, new object [] { trans_flags }));
598 if (OptAttributes != null)
599 OptAttributes.Emit ();
601 if (declarative_security != null) {
602 foreach (var de in declarative_security) {
603 MethodBuilder.AddDeclarativeSecurity (de.Key, de.Value);
607 if (MethodData != null)
608 MethodData.Emit (Parent);
616 protected void Error_ConditionalAttributeIsNotValid ()
618 Report.Error (577, Location,
619 "Conditional not valid on `{0}' because it is a constructor, destructor, operator or explicit interface implementation",
620 GetSignatureForError ());
623 public bool IsPartialDefinition {
625 return (ModFlags & Modifiers.PARTIAL) != 0 && Block == null;
629 public bool IsPartialImplementation {
631 return (ModFlags & Modifiers.PARTIAL) != 0 && Block != null;
635 public override string[] ValidAttributeTargets {
637 return attribute_targets;
641 #region IMethodData Members
643 public TypeSpec ReturnType {
649 public MemberName MethodName {
656 /// Returns true if method has conditional attribute and the conditions is not defined (method is excluded).
658 public override string[] ConditionalConditions ()
660 if ((caching_flags & (Flags.Excluded_Undetected | Flags.Excluded)) == 0)
663 if ((ModFlags & Modifiers.PARTIAL) != 0 && (caching_flags & Flags.Excluded) != 0)
664 return new string [0];
666 caching_flags &= ~Flags.Excluded_Undetected;
669 if (base_method == null) {
670 if (OptAttributes == null)
673 Attribute[] attrs = OptAttributes.SearchMulti (PredefinedAttributes.Get.Conditional);
677 conditions = new string[attrs.Length];
678 for (int i = 0; i < conditions.Length; ++i)
679 conditions[i] = attrs[i].GetConditionalAttributeValue ();
681 conditions = base_method.MemberDefinition.ConditionalConditions();
684 if (conditions != null)
685 caching_flags |= Flags.Excluded;
690 GenericMethod IMethodData.GenericMethod {
692 return GenericMethod;
696 public virtual void EmitExtraSymbolInfo (SourceMethod source)
703 public class SourceMethod : IMethodDef
706 SourceMethodBuilder builder;
708 protected SourceMethod (DeclSpace parent, MethodBase method, ICompileUnit file)
710 this.method = method;
712 builder = SymbolWriter.OpenMethod (file, parent.NamespaceEntry.SymbolFileID, this);
716 get { return method.Name; }
721 if (method is MethodBuilder)
722 return ((MethodBuilder) method).GetToken ().Token;
723 else if (method is ConstructorBuilder)
724 return ((ConstructorBuilder) method).GetToken ().Token;
726 throw new NotSupportedException ();
730 public void CloseMethod ()
732 SymbolWriter.CloseMethod ();
735 public void SetRealMethodName (string name)
738 builder.SetRealMethodName (name);
741 public static SourceMethod Create (DeclSpace parent, MethodBase method, Block block)
743 if (!SymbolWriter.HasSymbolWriter)
748 Location start_loc = block.StartLocation;
749 if (start_loc.IsNull)
752 ICompileUnit compile_unit = start_loc.CompilationUnit;
753 if (compile_unit == null)
756 return new SourceMethod (parent, method, compile_unit);
760 public class Method : MethodOrOperator, IGenericMethodDefinition
763 /// Modifiers allowed in a class declaration
765 const Modifiers AllowedModifiers =
768 Modifiers.PROTECTED |
779 const Modifiers AllowedInterfaceModifiers =
780 Modifiers.NEW | Modifiers.UNSAFE;
782 Method partialMethodImplementation;
784 public Method (DeclSpace parent, GenericMethod generic,
785 FullNamedExpression return_type, Modifiers mod,
786 MemberName name, ParametersCompiled parameters, Attributes attrs)
787 : base (parent, generic, return_type, mod,
788 parent.PartialContainer.Kind == MemberKind.Interface ? AllowedInterfaceModifiers : AllowedModifiers,
789 name, attrs, parameters)
793 protected Method (DeclSpace parent, FullNamedExpression return_type, Modifiers mod, Modifiers amod,
794 MemberName name, ParametersCompiled parameters, Attributes attrs)
795 : base (parent, null, return_type, mod, amod, name, attrs, parameters)
801 public override TypeParameter[] CurrentTypeParameters {
803 if (GenericMethod != null)
804 return GenericMethod.CurrentTypeParameters;
810 public override bool HasUnresolvedConstraints {
812 if (CurrentTypeParameters == null)
815 // When overriding base method constraints are fetched from
816 // base method but to find it we have to resolve parameters
817 // to find exact base method match
818 if (IsExplicitImpl || (ModFlags & Modifiers.OVERRIDE) != 0)
819 return base_method == null;
821 // Even for non-override generic method constraints check has to be
822 // delayed after all constraints are resolved
827 public TypeParameterSpec[] TypeParameters {
829 return CurrentTypeParameters.Select (l => l.Type).ToArray ();
833 public int TypeParametersCount {
835 return CurrentTypeParameters == null ? 0 : CurrentTypeParameters.Length;
841 public override string GetSignatureForError()
843 return base.GetSignatureForError () + parameters.GetSignatureForError ();
846 void Error_DuplicateEntryPoint (Method b)
848 Report.Error (17, b.Location,
849 "Program `{0}' has more than one entry point defined: `{1}'",
850 CodeGen.FileName, b.GetSignatureForError ());
855 if (ReturnType != TypeManager.void_type &&
856 ReturnType != TypeManager.int32_type)
859 if (parameters.IsEmpty)
862 if (parameters.Count > 1)
865 var ac = parameters.Types [0] as ArrayContainer;
866 return ac != null && ac.Rank == 1 && ac.Element == TypeManager.string_type &&
867 (parameters[0].ModFlags & ~Parameter.Modifier.PARAMS) == Parameter.Modifier.NONE;
870 public override FullNamedExpression LookupNamespaceOrType (string name, int arity, Location loc, bool ignore_cs0104)
873 TypeParameter[] tp = CurrentTypeParameters;
875 TypeParameter t = TypeParameter.FindTypeParameter (tp, name);
877 return new TypeParameterExpr (t, loc);
881 return base.LookupNamespaceOrType (name, arity, loc, ignore_cs0104);
884 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
886 if (a.Type == pa.Conditional) {
887 if (IsExplicitImpl) {
888 Error_ConditionalAttributeIsNotValid ();
892 if (ReturnType != TypeManager.void_type) {
893 Report.Error (578, Location, "Conditional not valid on `{0}' because its return type is not void", GetSignatureForError ());
897 if ((ModFlags & Modifiers.OVERRIDE) != 0) {
898 Report.Error (243, Location, "Conditional not valid on `{0}' because it is an override method", GetSignatureForError ());
903 Report.Error (582, Location, "Conditional not valid on interface members");
907 if (MethodData.implementing != null) {
908 Report.SymbolRelatedToPreviousError (MethodData.implementing.DeclaringType);
909 Report.Error (629, Location, "Conditional member `{0}' cannot implement interface member `{1}'",
910 GetSignatureForError (), TypeManager.CSharpSignature (MethodData.implementing));
914 for (int i = 0; i < parameters.Count; ++i) {
915 if (parameters.FixedParameters [i].ModFlags == Parameter.Modifier.OUT) {
916 Report.Error (685, Location, "Conditional method `{0}' cannot have an out parameter", GetSignatureForError ());
922 if (a.Type == pa.Extension) {
923 a.Error_MisusedExtensionAttribute ();
927 base.ApplyAttributeBuilder (a, ctor, cdata, pa);
930 protected override bool CheckForDuplications ()
932 if (!base.CheckForDuplications ())
935 var ar = Parent.PartialContainer.Properties;
937 for (int i = 0; i < ar.Count; ++i) {
938 PropertyBase pb = (PropertyBase) ar [i];
939 if (pb.AreAccessorsDuplicateImplementation (this))
944 ar = Parent.PartialContainer.Indexers;
946 for (int i = 0; i < ar.Count; ++i) {
947 PropertyBase pb = (PropertyBase) ar [i];
948 if (pb.AreAccessorsDuplicateImplementation (this))
956 protected virtual void DefineTypeParameters ()
958 var tparams = CurrentTypeParameters;
960 TypeParameterSpec[] base_tparams = null;
961 if (((ModFlags & Modifiers.OVERRIDE) != 0 || IsExplicitImpl)) {
962 if (base_method != null)
963 base_tparams = base_method.GenericDefinition.TypeParameters;
964 else if (MethodData.implementing != null)
965 base_tparams = MethodData.implementing.GenericDefinition.TypeParameters;
968 for (int i = 0; i < tparams.Length; ++i) {
971 if (!tp.ResolveConstraints (this))
975 // Copy base constraints for override/explicit methods
977 if (base_tparams != null) {
978 var base_tparam = base_tparams[i];
979 tp.Type.SpecialConstraint = base_tparam.SpecialConstraint;
980 tp.Type.TypeArguments = base_tparam.TypeArguments;
982 // TODO MemberCache: Inflate with different MVAR ?
983 tp.Type.Interfaces = base_tparam.Interfaces;
984 tp.Type.BaseType = base_tparam.BaseType;
985 } else if (MethodData.implementing != null) {
986 var base_tp = MethodData.implementing.Constraints[i];
987 if (!tp.Type.HasSameConstraintsImplementation (base_tp)) {
988 Report.SymbolRelatedToPreviousError (MethodData.implementing);
989 Report.Error (425, Location,
990 "The constraints for type parameter `{0}' of method `{1}' must match the constraints for type parameter `{2}' of interface method `{3}'. Consider using an explicit interface implementation instead",
991 tp.GetSignatureForError (), GetSignatureForError (), base_tp.GetSignatureForError (), MethodData.implementing.GetSignatureForError ());
1000 public override bool Define ()
1002 if (type_expr == TypeManager.system_void_expr && parameters.IsEmpty && Name == Destructor.MetadataName) {
1003 Report.Warning (465, 1, Location, "Introducing `Finalize' method can interfere with destructor invocation. Did you intend to declare a destructor?");
1006 if (!base.Define ())
1009 if (partialMethodImplementation != null && IsPartialDefinition)
1010 MethodBuilder = partialMethodImplementation.MethodBuilder;
1012 if (RootContext.StdLib && TypeManager.IsSpecialType (ReturnType)) {
1013 Error1599 (Location, ReturnType, Report);
1017 if (CurrentTypeParameters == null) {
1018 if (base_method != null) {
1019 if (parameters.Count == 1 && ParameterTypes[0] == TypeManager.object_type && Name == "Equals")
1020 Parent.PartialContainer.Mark_HasEquals ();
1021 else if (parameters.IsEmpty && Name == "GetHashCode")
1022 Parent.PartialContainer.Mark_HasGetHashCode ();
1026 DefineTypeParameters ();
1029 if (block != null && block.IsIterator && !(Parent is IteratorStorey)) {
1031 // Current method is turned into automatically generated
1032 // wrapper which creates an instance of iterator
1034 Iterator.CreateIterator (this, Parent.PartialContainer, ModFlags, Compiler);
1035 ModFlags |= Modifiers.DEBUGGER_HIDDEN;
1038 if ((ModFlags & Modifiers.STATIC) == 0)
1041 if (parameters.HasExtensionMethodType) {
1042 if (Parent.PartialContainer.IsStatic && !Parent.IsGeneric) {
1043 if (!Parent.IsTopLevel)
1044 Report.Error (1109, Location, "`{0}': Extension methods cannot be defined in a nested class",
1045 GetSignatureForError ());
1047 PredefinedAttribute pa = PredefinedAttributes.Get.Extension;
1048 if (!pa.IsDefined) {
1049 Report.Error (1110, Location,
1050 "`{0}': Extension methods cannot be declared without a reference to System.Core.dll assembly. Add the assembly reference or remove `this' modifer from the first parameter",
1051 GetSignatureForError ());
1054 ModFlags |= Modifiers.METHOD_EXTENSION;
1055 Parent.PartialContainer.ModFlags |= Modifiers.METHOD_EXTENSION;
1056 Spec.DeclaringType.SetExtensionMethodContainer ();
1057 CodeGen.Assembly.HasExtensionMethods = true;
1059 Report.Error (1106, Location, "`{0}': Extension methods must be defined in a non-generic static class",
1060 GetSignatureForError ());
1065 // This is used to track the Entry Point,
1067 if (RootContext.NeedsEntryPoint &&
1069 (RootContext.MainClass == null ||
1070 RootContext.MainClass == Parent.TypeBuilder.FullName)){
1071 if (IsEntryPoint ()) {
1073 if (RootContext.EntryPoint == null) {
1074 if (Parent.IsGeneric || MemberName.IsGeneric) {
1075 Report.Warning (402, 4, Location, "`{0}': an entry point cannot be generic or in a generic type",
1076 GetSignatureForError ());
1079 RootContext.EntryPoint = this;
1082 Error_DuplicateEntryPoint (RootContext.EntryPoint);
1083 Error_DuplicateEntryPoint (this);
1086 Report.Warning (28, 4, Location, "`{0}' has the wrong signature to be an entry point",
1087 GetSignatureForError ());
1097 public override void Emit ()
1100 Report.Debug (64, "METHOD EMIT", this, MethodBuilder, Location, Block, MethodData);
1101 if (IsPartialDefinition) {
1103 // Use partial method implementation builder for partial method declaration attributes
1105 if (partialMethodImplementation != null) {
1106 MethodBuilder = partialMethodImplementation.MethodBuilder;
1109 } else if ((ModFlags & Modifiers.PARTIAL) != 0 && (caching_flags & Flags.PartialDefinitionExists) == 0) {
1110 Report.Error (759, Location, "A partial method `{0}' implementation is missing a partial method declaration",
1111 GetSignatureForError ());
1114 if (CurrentTypeParameters != null) {
1115 var ge = type_expr as GenericTypeExpr;
1117 ge.CheckConstraints (this);
1119 foreach (Parameter p in parameters.FixedParameters) {
1120 ge = p.TypeExpression as GenericTypeExpr;
1122 ge.CheckConstraints (this);
1125 for (int i = 0; i < CurrentTypeParameters.Length; ++i) {
1126 var tp = CurrentTypeParameters [i];
1127 tp.CheckGenericConstraints ();
1134 if ((ModFlags & Modifiers.METHOD_EXTENSION) != 0)
1135 PredefinedAttributes.Get.Extension.EmitAttribute (MethodBuilder);
1137 Console.WriteLine ("Internal compiler error at {0}: exception caught while emitting {1}",
1138 Location, MethodBuilder);
1143 public override bool EnableOverloadChecks (MemberCore overload)
1145 // TODO: It can be deleted when members will be defined in correct order
1146 if (overload is Operator)
1147 return overload.EnableOverloadChecks (this);
1149 if (overload is Indexer)
1152 return base.EnableOverloadChecks (overload);
1155 public static void Error1599 (Location loc, TypeSpec t, Report Report)
1157 Report.Error (1599, loc, "Method or delegate cannot return type `{0}'", TypeManager.CSharpName (t));
1160 protected override bool ResolveMemberType ()
1162 if (GenericMethod != null) {
1163 MethodBuilder = Parent.TypeBuilder.DefineMethod (GetFullName (MemberName), flags);
1164 if (!GenericMethod.Define (this))
1168 return base.ResolveMemberType ();
1171 public void SetPartialDefinition (Method methodDefinition)
1173 caching_flags |= Flags.PartialDefinitionExists;
1174 methodDefinition.partialMethodImplementation = this;
1176 // Ensure we are always using method declaration parameters
1177 for (int i = 0; i < methodDefinition.parameters.Count; ++i ) {
1178 parameters [i].Name = methodDefinition.parameters [i].Name;
1179 parameters [i].DefaultValue = methodDefinition.parameters [i].DefaultValue;
1182 if (methodDefinition.attributes == null)
1185 if (attributes == null) {
1186 attributes = methodDefinition.attributes;
1188 attributes.Attrs.AddRange (methodDefinition.attributes.Attrs);
1193 public abstract class ConstructorInitializer : ExpressionStatement
1195 Arguments argument_list;
1196 MethodGroupExpr base_constructor_group;
1198 public ConstructorInitializer (Arguments argument_list, Location loc)
1200 this.argument_list = argument_list;
1204 public Arguments Arguments {
1206 return argument_list;
1210 public override Expression CreateExpressionTree (ResolveContext ec)
1212 throw new NotSupportedException ("ET");
1215 protected override Expression DoResolve (ResolveContext ec)
1217 eclass = ExprClass.Value;
1220 var caller_builder = (Constructor) ec.MemberContext;
1222 if (argument_list != null) {
1226 // Spec mandates that constructor initializer will not have `this' access
1228 using (ec.Set (ResolveContext.Options.BaseInitializer)) {
1229 argument_list.Resolve (ec, out dynamic);
1233 ec.Report.Error (1975, loc,
1234 "The constructor call cannot be dynamically dispatched within constructor initializer");
1240 type = ec.CurrentType;
1241 if (this is ConstructorBaseInitializer) {
1242 if (ec.CurrentType.BaseType == null)
1245 type = ec.CurrentType.BaseType;
1246 if (ec.CurrentType.IsStruct) {
1247 ec.Report.Error (522, loc,
1248 "`{0}': Struct constructors cannot call base constructors", caller_builder.GetSignatureForError ());
1253 // It is legal to have "this" initializers that take no arguments
1254 // in structs, they are just no-ops.
1256 // struct D { public D (int a) : this () {}
1258 if (TypeManager.IsStruct (ec.CurrentType) && argument_list == null)
1262 base_constructor_group = MemberLookupFinal (
1263 ec, null, type, ConstructorBuilder.ConstructorName, 0, MemberKind.Constructor,
1264 BindingRestriction.AccessibleOnly | BindingRestriction.DeclaredOnly,
1265 loc) as MethodGroupExpr;
1267 if (base_constructor_group == null)
1270 base_constructor_group = base_constructor_group.OverloadResolve (
1271 ec, ref argument_list, false, loc);
1273 if (base_constructor_group == null)
1277 base_constructor_group.InstanceExpression = ec.GetThis (loc);
1279 var base_ctor = base_constructor_group.BestCandidate;
1281 // TODO MemberCache: Does it work for inflated types ?
1282 if (base_ctor == caller_builder.Spec){
1283 ec.Report.Error (516, loc, "Constructor `{0}' cannot call itself",
1284 caller_builder.GetSignatureForError ());
1290 public override void Emit (EmitContext ec)
1292 // It can be null for static initializers
1293 if (base_constructor_group == null)
1298 base_constructor_group.EmitCall (ec, argument_list);
1301 public override void EmitStatement (EmitContext ec)
1307 public class ConstructorBaseInitializer : ConstructorInitializer {
1308 public ConstructorBaseInitializer (Arguments argument_list, Location l) :
1309 base (argument_list, l)
1314 class GeneratedBaseInitializer: ConstructorBaseInitializer {
1315 public GeneratedBaseInitializer (Location loc):
1321 public class ConstructorThisInitializer : ConstructorInitializer {
1322 public ConstructorThisInitializer (Arguments argument_list, Location l) :
1323 base (argument_list, l)
1328 public class Constructor : MethodCore, IMethodData {
1329 public ConstructorBuilder ConstructorBuilder;
1330 public ConstructorInitializer Initializer;
1331 Dictionary<SecurityAction, PermissionSet> declarative_security;
1332 bool has_compliant_args;
1335 // Modifiers allowed for a constructor.
1337 public const Modifiers AllowedModifiers =
1339 Modifiers.PROTECTED |
1340 Modifiers.INTERNAL |
1346 static readonly string[] attribute_targets = new string [] { "method" };
1349 // The spec claims that static is not permitted, but
1350 // my very own code has static constructors.
1352 public Constructor (DeclSpace parent, string name, Modifiers mod, Attributes attrs, ParametersCompiled args,
1353 ConstructorInitializer init, Location loc)
1354 : base (parent, null, null, mod, AllowedModifiers,
1355 new MemberName (name, loc), attrs, args)
1360 public bool HasCompliantArgs {
1361 get { return has_compliant_args; }
1364 public override AttributeTargets AttributeTargets {
1365 get { return AttributeTargets.Constructor; }
1369 // Returns true if this is a default constructor
1371 public bool IsDefault ()
1373 if ((ModFlags & Modifiers.STATIC) != 0)
1374 return parameters.IsEmpty;
1376 return parameters.IsEmpty &&
1377 (Initializer is ConstructorBaseInitializer) &&
1378 (Initializer.Arguments == null);
1381 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
1383 if (a.IsValidSecurityAttribute ()) {
1384 if (declarative_security == null) {
1385 declarative_security = new Dictionary<SecurityAction, PermissionSet> ();
1387 a.ExtractSecurityPermissionSet (declarative_security);
1391 if (a.IsInternalMethodImplAttribute) {
1392 is_external_implementation = true;
1395 ConstructorBuilder.SetCustomAttribute ((ConstructorInfo) ctor.GetMetaInfo (), cdata);
1398 protected override bool CheckBase ()
1400 if ((ModFlags & Modifiers.STATIC) != 0) {
1401 if (!parameters.IsEmpty) {
1402 Report.Error (132, Location, "`{0}': The static constructor must be parameterless",
1403 GetSignatureForError ());
1407 // the rest can be ignored
1411 // Check whether arguments were correct.
1412 if (!DefineParameters (parameters))
1415 if ((caching_flags & Flags.MethodOverloadsExist) != 0)
1416 Parent.MemberCache.CheckExistingMembersOverloads (this, parameters);
1418 if (Parent.PartialContainer.Kind == MemberKind.Struct && parameters.IsEmpty) {
1419 Report.Error (568, Location,
1420 "Structs cannot contain explicit parameterless constructors");
1424 CheckProtectedModifier ();
1430 // Creates the ConstructorBuilder
1432 public override bool Define ()
1434 if (ConstructorBuilder != null)
1437 var ca = MethodAttributes.RTSpecialName | MethodAttributes.SpecialName;
1439 if ((ModFlags & Modifiers.STATIC) != 0) {
1440 ca |= MethodAttributes.Static | MethodAttributes.Private;
1442 ca |= ModifiersExtensions.MethodAttr (ModFlags);
1445 if (!CheckAbstractAndExtern (block != null))
1448 // Check if arguments were correct.
1452 ConstructorBuilder = Parent.TypeBuilder.DefineConstructor (
1453 ca, CallingConventions,
1454 parameters.GetMetaInfo ());
1456 spec = new MethodSpec (MemberKind.Constructor, Parent.Definition, this, TypeManager.void_type, ConstructorBuilder, parameters, ModFlags);
1458 Parent.MemberCache.AddMember (spec);
1460 // It's here only to report an error
1461 if (block != null && block.IsIterator) {
1462 member_type = TypeManager.void_type;
1463 Iterator.CreateIterator (this, Parent.PartialContainer, ModFlags, Compiler);
1472 public override void Emit ()
1474 if (Parent.PartialContainer.IsComImport) {
1475 if (!IsDefault ()) {
1476 Report.Error (669, Location, "`{0}': A class with the ComImport attribute cannot have a user-defined constructor",
1477 Parent.GetSignatureForError ());
1479 ConstructorBuilder.SetImplementationFlags (MethodImplAttributes.InternalCall);
1482 if ((ModFlags & Modifiers.DEBUGGER_HIDDEN) != 0)
1483 PredefinedAttributes.Get.DebuggerHidden.EmitAttribute (ConstructorBuilder);
1485 if (OptAttributes != null)
1486 OptAttributes.Emit ();
1491 // If we use a "this (...)" constructor initializer, then
1492 // do not emit field initializers, they are initialized in the other constructor
1494 bool emit_field_initializers = ((ModFlags & Modifiers.STATIC) != 0) ||
1495 !(Initializer is ConstructorThisInitializer);
1497 BlockContext bc = new BlockContext (this, block, TypeManager.void_type);
1498 bc.Set (ResolveContext.Options.ConstructorScope);
1500 if (emit_field_initializers)
1501 Parent.PartialContainer.ResolveFieldInitializers (bc);
1503 if (block != null) {
1504 // If this is a non-static `struct' constructor and doesn't have any
1505 // initializer, it must initialize all of the struct's fields.
1506 if ((Parent.PartialContainer.Kind == MemberKind.Struct) &&
1507 ((ModFlags & Modifiers.STATIC) == 0) && (Initializer == null))
1508 block.AddThisVariable (Parent, Location);
1510 if (block != null && (ModFlags & Modifiers.STATIC) == 0){
1511 if (Parent.PartialContainer.Kind == MemberKind.Class && Initializer == null)
1512 Initializer = new GeneratedBaseInitializer (Location);
1514 if (Initializer != null) {
1515 block.AddScopeStatement (new StatementExpression (Initializer));
1520 parameters.ApplyAttributes (ConstructorBuilder);
1522 SourceMethod source = SourceMethod.Create (Parent, ConstructorBuilder, block);
1524 if (block != null) {
1525 if (block.Resolve (null, bc, parameters, this)) {
1526 EmitContext ec = new EmitContext (this, ConstructorBuilder.GetILGenerator (), bc.ReturnType);
1527 ec.With (EmitContext.Options.ConstructorScope, true);
1529 if (!ec.HasReturnLabel && bc.HasReturnLabel) {
1530 ec.ReturnLabel = bc.ReturnLabel;
1531 ec.HasReturnLabel = true;
1539 source.CloseMethod ();
1541 if (declarative_security != null) {
1542 foreach (var de in declarative_security) {
1543 ConstructorBuilder.AddDeclarativeSecurity (de.Key, de.Value);
1550 protected override MemberSpec FindBaseMember (out MemberSpec bestCandidate)
1552 // Is never override
1553 bestCandidate = null;
1557 public override string GetSignatureForError()
1559 return base.GetSignatureForError () + parameters.GetSignatureForError ();
1562 public override string[] ValidAttributeTargets {
1564 return attribute_targets;
1568 protected override bool VerifyClsCompliance ()
1570 if (!base.VerifyClsCompliance () || !IsExposedFromAssembly ()) {
1574 if (!parameters.IsEmpty && Parent.Definition.IsAttribute) {
1575 foreach (TypeSpec param in parameters.Types) {
1576 if (param.IsArray) {
1582 has_compliant_args = true;
1586 #region IMethodData Members
1588 public MemberName MethodName {
1594 public TypeSpec ReturnType {
1600 public EmitContext CreateEmitContext (ILGenerator ig)
1602 throw new NotImplementedException ();
1605 public bool IsExcluded()
1610 GenericMethod IMethodData.GenericMethod {
1616 void IMethodData.EmitExtraSymbolInfo (SourceMethod source)
1623 /// Interface for MethodData class. Holds links to parent members to avoid member duplication.
1625 public interface IMethodData
1627 CallingConventions CallingConventions { get; }
1628 Location Location { get; }
1629 MemberName MethodName { get; }
1630 TypeSpec ReturnType { get; }
1631 GenericMethod GenericMethod { get; }
1632 ParametersCompiled ParameterInfo { get; }
1633 MethodSpec Spec { get; }
1635 Attributes OptAttributes { get; }
1636 ToplevelBlock Block { get; set; }
1638 EmitContext CreateEmitContext (ILGenerator ig);
1639 string GetSignatureForError ();
1640 void EmitExtraSymbolInfo (SourceMethod source);
1644 // Encapsulates most of the Method's state
1646 public class MethodData {
1647 static FieldInfo methodbuilder_attrs_field;
1648 public readonly IMethodData method;
1650 public readonly GenericMethod GenericMethod;
1653 // Are we implementing an interface ?
1655 public MethodSpec implementing;
1660 protected InterfaceMemberBase member;
1661 protected Modifiers modifiers;
1662 protected MethodAttributes flags;
1663 protected TypeSpec declaring_type;
1664 protected MethodSpec parent_method;
1666 MethodBuilder builder;
1667 public MethodBuilder MethodBuilder {
1673 public TypeSpec DeclaringType {
1675 return declaring_type;
1679 public MethodData (InterfaceMemberBase member,
1680 Modifiers modifiers, MethodAttributes flags, IMethodData method)
1682 this.member = member;
1683 this.modifiers = modifiers;
1686 this.method = method;
1689 public MethodData (InterfaceMemberBase member,
1690 Modifiers modifiers, MethodAttributes flags,
1691 IMethodData method, MethodBuilder builder,
1692 GenericMethod generic, MethodSpec parent_method)
1693 : this (member, modifiers, flags, method)
1695 this.builder = builder;
1696 this.GenericMethod = generic;
1697 this.parent_method = parent_method;
1700 public bool Define (DeclSpace parent, string method_full_name, Report Report)
1702 TypeContainer container = parent.PartialContainer;
1704 PendingImplementation pending = container.PendingImplementations;
1705 if (pending != null){
1706 implementing = pending.IsInterfaceMethod (method.MethodName, member.InterfaceType, this);
1708 if (member.InterfaceType != null){
1709 if (implementing == null){
1710 if (member is PropertyBase) {
1711 Report.Error (550, method.Location, "`{0}' is an accessor not found in interface member `{1}{2}'",
1712 method.GetSignatureForError (), TypeManager.CSharpName (member.InterfaceType),
1713 member.GetSignatureForError ().Substring (member.GetSignatureForError ().LastIndexOf ('.')));
1716 Report.Error (539, method.Location,
1717 "`{0}.{1}' in explicit interface declaration is not a member of interface",
1718 TypeManager.CSharpName (member.InterfaceType), member.ShortName);
1722 if (implementing.IsAccessor && !(method is AbstractPropertyEventMethod)) {
1723 Report.SymbolRelatedToPreviousError (implementing);
1724 Report.Error (683, method.Location, "`{0}' explicit method implementation cannot implement `{1}' because it is an accessor",
1725 member.GetSignatureForError (), TypeManager.CSharpSignature (implementing));
1729 if (implementing != null) {
1730 AbstractPropertyEventMethod prop_method = method as AbstractPropertyEventMethod;
1731 if (prop_method == null) {
1732 if (implementing.IsAccessor) {
1733 Report.SymbolRelatedToPreviousError (implementing);
1734 Report.Error (470, method.Location, "Method `{0}' cannot implement interface accessor `{1}'",
1735 method.GetSignatureForError (), TypeManager.CSharpSignature (implementing));
1737 } else if (implementing.DeclaringType.IsInterface) {
1738 if (!implementing.IsAccessor) {
1739 Report.SymbolRelatedToPreviousError (implementing);
1740 Report.Error (686, method.Location, "Accessor `{0}' cannot implement interface member `{1}' for type `{2}'. Use an explicit interface implementation",
1741 method.GetSignatureForError (), TypeManager.CSharpSignature (implementing), container.GetSignatureForError ());
1744 PropertyBase.PropertyMethod pm = prop_method as PropertyBase.PropertyMethod;
1745 if (pm != null && pm.HasCustomAccessModifier && (pm.ModFlags & Modifiers.PUBLIC) == 0) {
1746 Report.SymbolRelatedToPreviousError (implementing);
1747 Report.Error (277, method.Location, "Accessor `{0}' must be declared public to implement interface member `{1}'",
1748 method.GetSignatureForError (), implementing.GetSignatureForError ());
1757 // For implicit implementations, make sure we are public, for
1758 // explicit implementations, make sure we are private.
1760 if (implementing != null){
1762 // Setting null inside this block will trigger a more
1763 // verbose error reporting for missing interface implementations
1765 // The "candidate" function has been flagged already
1766 // but it wont get cleared
1768 if (member.IsExplicitImpl){
1769 if (method.ParameterInfo.HasParams && !implementing.Parameters.HasParams) {
1770 Report.SymbolRelatedToPreviousError (implementing);
1771 Report.Error (466, method.Location, "`{0}': the explicit interface implementation cannot introduce the params modifier",
1772 method.GetSignatureForError ());
1776 if (implementing.DeclaringType.IsInterface) {
1778 // If this is an interface method implementation,
1779 // check for public accessibility
1781 if ((flags & MethodAttributes.MemberAccessMask) != MethodAttributes.Public)
1783 implementing = null;
1785 } else if ((flags & MethodAttributes.MemberAccessMask) == MethodAttributes.Private){
1786 // We may never be private.
1787 implementing = null;
1789 } else if ((modifiers & Modifiers.OVERRIDE) == 0){
1791 // We may be protected if we're overriding something.
1793 implementing = null;
1798 // Static is not allowed
1800 if ((modifiers & Modifiers.STATIC) != 0){
1801 implementing = null;
1806 // If implementing is still valid, set flags
1808 if (implementing != null){
1810 // When implementing interface methods, set NewSlot
1811 // unless, we are overwriting a method.
1813 if (implementing.DeclaringType.IsInterface){
1814 if ((modifiers & Modifiers.OVERRIDE) == 0)
1815 flags |= MethodAttributes.NewSlot;
1818 MethodAttributes.Virtual |
1819 MethodAttributes.HideBySig;
1821 // Set Final unless we're virtual, abstract or already overriding a method.
1822 if ((modifiers & (Modifiers.VIRTUAL | Modifiers.ABSTRACT | Modifiers.OVERRIDE)) == 0)
1823 flags |= MethodAttributes.Final;
1826 DefineMethodBuilder (container, method_full_name, method.ParameterInfo);
1828 if (builder == null)
1831 // if (container.CurrentType != null)
1832 // declaring_type = container.CurrentType;
1834 declaring_type = container.Definition;
1836 if (implementing != null && member.IsExplicitImpl) {
1837 container.TypeBuilder.DefineMethodOverride (builder, (MethodInfo) implementing.GetMetaInfo ());
1845 /// Create the MethodBuilder for the method
1847 void DefineMethodBuilder (TypeContainer container, string method_name, ParametersCompiled param)
1849 var return_type = method.ReturnType.GetMetaInfo ();
1850 var p_types = param.GetMetaInfo ();
1852 if (builder == null) {
1853 builder = container.TypeBuilder.DefineMethod (
1854 method_name, flags, method.CallingConventions,
1855 return_type, p_types);
1860 // Generic method has been already defined to resolve method parameters
1861 // correctly when they use type parameters
1863 builder.SetParameters (p_types);
1864 builder.SetReturnType (return_type);
1865 if (builder.Attributes != flags) {
1867 if (methodbuilder_attrs_field == null)
1868 methodbuilder_attrs_field = typeof (MethodBuilder).GetField ("attrs", BindingFlags.NonPublic | BindingFlags.Instance);
1869 methodbuilder_attrs_field.SetValue (builder, flags);
1871 container.Compiler.Report.RuntimeMissingSupport (method.Location, "Generic method MethodAttributes");
1879 public void Emit (DeclSpace parent)
1881 if (GenericMethod != null)
1882 GenericMethod.EmitAttributes ();
1884 method.ParameterInfo.ApplyAttributes (MethodBuilder);
1887 // clear the pending implementation flag
1889 if (implementing != null)
1890 parent.PartialContainer.PendingImplementations.ImplementMethod (method.MethodName,
1891 member.InterfaceType, this, member.IsExplicitImpl);
1893 SourceMethod source = SourceMethod.Create (parent, MethodBuilder, method.Block);
1895 ToplevelBlock block = method.Block;
1896 if (block != null) {
1897 BlockContext bc = new BlockContext ((IMemberContext) method, block, method.ReturnType);
1898 if (block.Resolve (null, bc, method.ParameterInfo, method)) {
1899 EmitContext ec = method.CreateEmitContext (MethodBuilder.GetILGenerator ());
1900 if (!ec.HasReturnLabel && bc.HasReturnLabel) {
1901 ec.ReturnLabel = bc.ReturnLabel;
1902 ec.HasReturnLabel = true;
1909 if (source != null) {
1910 method.EmitExtraSymbolInfo (source);
1911 source.CloseMethod ();
1916 public class Destructor : MethodOrOperator
1918 const Modifiers AllowedModifiers =
1922 static readonly string[] attribute_targets = new string [] { "method" };
1924 public static readonly string MetadataName = "Finalize";
1926 public Destructor (DeclSpace parent, Modifiers mod, ParametersCompiled parameters, Attributes attrs, Location l)
1927 : base (parent, null, TypeManager.system_void_expr, mod, AllowedModifiers,
1928 new MemberName (MetadataName, l), attrs, parameters)
1930 ModFlags &= ~Modifiers.PRIVATE;
1931 ModFlags |= Modifiers.PROTECTED | Modifiers.OVERRIDE;
1934 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
1936 if (a.Type == pa.Conditional) {
1937 Error_ConditionalAttributeIsNotValid ();
1941 base.ApplyAttributeBuilder (a, ctor, cdata, pa);
1944 protected override bool CheckBase ()
1946 if (!base.CheckBase ())
1949 var base_type = Parent.PartialContainer.BaseType;
1950 if (base_type == null)
1953 if (Block != null) {
1954 MethodGroupExpr method_expr = Expression.MethodLookup (Parent.Module.Compiler, Parent.Definition, base_type, MemberKind.Destructor, MetadataName, 0, Location);
1955 if (method_expr == null)
1956 throw new NotImplementedException ();
1958 method_expr.IsBase = true;
1959 method_expr.InstanceExpression = new CompilerGeneratedThis (Parent.Definition, Location);
1961 ToplevelBlock new_block = new ToplevelBlock (Compiler, Block.StartLocation);
1962 new_block.EndLocation = Block.EndLocation;
1964 Block finaly_block = new ExplicitBlock (new_block, Location, Location);
1965 Block try_block = new Block (new_block, block);
1968 // 0-size arguments to avoid CS0250 error
1969 // TODO: Should use AddScopeStatement or something else which emits correct
1972 finaly_block.AddStatement (new StatementExpression (new Invocation (method_expr, new Arguments (0))));
1973 new_block.AddStatement (new TryFinally (try_block, finaly_block, Location));
1981 public override string GetSignatureForError ()
1983 return Parent.GetSignatureForError () + ".~" + Parent.MemberName.Name + "()";
1986 public override string[] ValidAttributeTargets {
1988 return attribute_targets;
1993 // Ooouh Martin, templates are missing here.
1994 // When it will be possible move here a lot of child code and template method type.
1995 public abstract class AbstractPropertyEventMethod : MemberCore, IMethodData {
1996 protected MethodData method_data;
1997 protected ToplevelBlock block;
1998 protected Dictionary<SecurityAction, PermissionSet> declarative_security;
2000 // The accessor are created even if they are not wanted.
2001 // But we need them because their names are reserved.
2002 // Field says whether accessor will be emited or not
2003 public readonly bool IsDummy;
2005 protected readonly string prefix;
2007 ReturnParameter return_attributes;
2009 public AbstractPropertyEventMethod (PropertyBasedMember member, string prefix)
2010 : base (member.Parent, SetupName (prefix, member, member.Location), null)
2012 this.prefix = prefix;
2016 public AbstractPropertyEventMethod (InterfaceMemberBase member, Accessor accessor,
2018 : base (member.Parent, SetupName (prefix, member, accessor.Location),
2019 accessor.Attributes)
2021 this.prefix = prefix;
2022 this.block = accessor.Block;
2025 static MemberName SetupName (string prefix, InterfaceMemberBase member, Location loc)
2027 return new MemberName (member.MemberName.Left, prefix + member.ShortName, loc);
2030 public void UpdateName (InterfaceMemberBase member)
2032 SetMemberName (SetupName (prefix, member, Location));
2035 #region IMethodData Members
2037 public ToplevelBlock Block {
2047 public CallingConventions CallingConventions {
2049 return CallingConventions.Standard;
2053 public EmitContext CreateEmitContext (ILGenerator ig)
2055 return new EmitContext (this, ig, ReturnType);
2058 public bool IsExcluded ()
2063 GenericMethod IMethodData.GenericMethod {
2069 public MemberName MethodName {
2075 public TypeSpec[] ParameterTypes {
2077 return ParameterInfo.Types;
2081 public abstract ParametersCompiled ParameterInfo { get ; }
2082 public abstract TypeSpec ReturnType { get; }
2086 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
2088 if (a.Type == pa.CLSCompliant || a.Type == pa.Obsolete || a.Type == pa.Conditional) {
2089 Report.Error (1667, a.Location,
2090 "Attribute `{0}' is not valid on property or event accessors. It is valid on `{1}' declarations only",
2091 TypeManager.CSharpName (a.Type), a.GetValidTargets ());
2095 if (a.IsValidSecurityAttribute ()) {
2096 if (declarative_security == null)
2097 declarative_security = new Dictionary<SecurityAction, PermissionSet> ();
2098 a.ExtractSecurityPermissionSet (declarative_security);
2102 if (a.Target == AttributeTargets.Method) {
2103 method_data.MethodBuilder.SetCustomAttribute ((ConstructorInfo) ctor.GetMetaInfo (), cdata);
2107 if (a.Target == AttributeTargets.ReturnValue) {
2108 if (return_attributes == null)
2109 return_attributes = new ReturnParameter (this, method_data.MethodBuilder, Location);
2111 return_attributes.ApplyAttributeBuilder (a, ctor, cdata, pa);
2115 ApplyToExtraTarget (a, ctor, cdata, pa);
2118 protected virtual void ApplyToExtraTarget (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
2120 throw new NotSupportedException ("You forgot to define special attribute target handling");
2123 // It is not supported for the accessors
2124 public sealed override bool Define()
2126 throw new NotSupportedException ();
2129 public virtual void Emit (DeclSpace parent)
2131 method_data.Emit (parent);
2133 if ((ModFlags & Modifiers.COMPILER_GENERATED) != 0 && !Parent.IsCompilerGenerated)
2134 PredefinedAttributes.Get.CompilerGenerated.EmitAttribute (method_data.MethodBuilder);
2135 if (((ModFlags & Modifiers.DEBUGGER_HIDDEN) != 0))
2136 PredefinedAttributes.Get.DebuggerHidden.EmitAttribute (method_data.MethodBuilder);
2138 if (ReturnType == InternalType.Dynamic) {
2139 return_attributes = new ReturnParameter (this, method_data.MethodBuilder, Location);
2140 PredefinedAttributes.Get.Dynamic.EmitAttribute (return_attributes.Builder);
2142 var trans_flags = TypeManager.HasDynamicTypeUsed (ReturnType);
2143 if (trans_flags != null) {
2144 var pa = PredefinedAttributes.Get.DynamicTransform;
2145 if (pa.Constructor != null || pa.ResolveConstructor (Location, ArrayContainer.MakeType (TypeManager.bool_type))) {
2146 return_attributes = new ReturnParameter (this, method_data.MethodBuilder, Location);
2147 return_attributes.Builder.SetCustomAttribute (
2148 new CustomAttributeBuilder (pa.Constructor, new object [] { trans_flags }));
2153 if (OptAttributes != null)
2154 OptAttributes.Emit ();
2156 if (declarative_security != null) {
2157 foreach (var de in declarative_security) {
2158 method_data.MethodBuilder.AddDeclarativeSecurity (de.Key, de.Value);
2165 public override bool EnableOverloadChecks (MemberCore overload)
2167 // This can only happen with indexers and it will
2168 // be catched as indexer difference
2169 if (overload is AbstractPropertyEventMethod)
2172 if (overload is MethodCore) {
2173 caching_flags |= Flags.MethodOverloadsExist;
2179 public override bool IsClsComplianceRequired()
2184 public bool IsDuplicateImplementation (MethodCore method)
2186 if (!MemberName.Equals (method.MemberName))
2189 TypeSpec[] param_types = method.ParameterTypes;
2191 if (param_types == null || param_types.Length != ParameterTypes.Length)
2194 for (int i = 0; i < param_types.Length; i++)
2195 if (param_types [i] != ParameterTypes [i])
2198 Report.SymbolRelatedToPreviousError (method);
2199 Report.Error (82, Location, "A member `{0}' is already reserved",
2200 method.GetSignatureForError ());
2204 public override bool IsUsed {
2213 public MethodSpec Spec { get; protected set; }
2216 // Represents header string for documentation comment.
2218 public override string DocCommentHeader {
2219 get { throw new InvalidOperationException ("Unexpected attempt to get doc comment from " + this.GetType () + "."); }
2222 void IMethodData.EmitExtraSymbolInfo (SourceMethod source)
2226 public class Operator : MethodOrOperator {
2228 const Modifiers AllowedModifiers =
2234 public enum OpType : byte {
2244 // Unary and Binary operators
2267 // Implicit and Explicit
2271 // Just because of enum
2275 public readonly OpType OperatorType;
2277 static readonly string [] [] names;
2281 names = new string[(int)OpType.TOP][];
2282 names [(int) OpType.LogicalNot] = new string [] { "!", "op_LogicalNot" };
2283 names [(int) OpType.OnesComplement] = new string [] { "~", "op_OnesComplement" };
2284 names [(int) OpType.Increment] = new string [] { "++", "op_Increment" };
2285 names [(int) OpType.Decrement] = new string [] { "--", "op_Decrement" };
2286 names [(int) OpType.True] = new string [] { "true", "op_True" };
2287 names [(int) OpType.False] = new string [] { "false", "op_False" };
2288 names [(int) OpType.Addition] = new string [] { "+", "op_Addition" };
2289 names [(int) OpType.Subtraction] = new string [] { "-", "op_Subtraction" };
2290 names [(int) OpType.UnaryPlus] = new string [] { "+", "op_UnaryPlus" };
2291 names [(int) OpType.UnaryNegation] = new string [] { "-", "op_UnaryNegation" };
2292 names [(int) OpType.Multiply] = new string [] { "*", "op_Multiply" };
2293 names [(int) OpType.Division] = new string [] { "/", "op_Division" };
2294 names [(int) OpType.Modulus] = new string [] { "%", "op_Modulus" };
2295 names [(int) OpType.BitwiseAnd] = new string [] { "&", "op_BitwiseAnd" };
2296 names [(int) OpType.BitwiseOr] = new string [] { "|", "op_BitwiseOr" };
2297 names [(int) OpType.ExclusiveOr] = new string [] { "^", "op_ExclusiveOr" };
2298 names [(int) OpType.LeftShift] = new string [] { "<<", "op_LeftShift" };
2299 names [(int) OpType.RightShift] = new string [] { ">>", "op_RightShift" };
2300 names [(int) OpType.Equality] = new string [] { "==", "op_Equality" };
2301 names [(int) OpType.Inequality] = new string [] { "!=", "op_Inequality" };
2302 names [(int) OpType.GreaterThan] = new string [] { ">", "op_GreaterThan" };
2303 names [(int) OpType.LessThan] = new string [] { "<", "op_LessThan" };
2304 names [(int) OpType.GreaterThanOrEqual] = new string [] { ">=", "op_GreaterThanOrEqual" };
2305 names [(int) OpType.LessThanOrEqual] = new string [] { "<=", "op_LessThanOrEqual" };
2306 names [(int) OpType.Implicit] = new string [] { "implicit", "op_Implicit" };
2307 names [(int) OpType.Explicit] = new string [] { "explicit", "op_Explicit" };
2310 public Operator (DeclSpace parent, OpType type, FullNamedExpression ret_type,
2311 Modifiers mod_flags, ParametersCompiled parameters,
2312 ToplevelBlock block, Attributes attrs, Location loc)
2313 : base (parent, null, ret_type, mod_flags, AllowedModifiers,
2314 new MemberName (GetMetadataName (type), loc), attrs, parameters)
2316 OperatorType = type;
2320 public override void ApplyAttributeBuilder (Attribute a, MethodSpec ctor, byte[] cdata, PredefinedAttributes pa)
2322 if (a.Type == pa.Conditional) {
2323 Error_ConditionalAttributeIsNotValid ();
2327 base.ApplyAttributeBuilder (a, ctor, cdata, pa);
2330 public override bool Define ()
2332 const Modifiers RequiredModifiers = Modifiers.PUBLIC | Modifiers.STATIC;
2333 if ((ModFlags & RequiredModifiers) != RequiredModifiers){
2334 Report.Error (558, Location, "User-defined operator `{0}' must be declared static and public", GetSignatureForError ());
2337 if (!base.Define ())
2340 if (block != null && block.IsIterator && !(Parent is IteratorStorey)) {
2342 // Current method is turned into automatically generated
2343 // wrapper which creates an instance of iterator
2345 Iterator.CreateIterator (this, Parent.PartialContainer, ModFlags, Compiler);
2346 ModFlags |= Modifiers.DEBUGGER_HIDDEN;
2349 // imlicit and explicit operator of same types are not allowed
2350 if (OperatorType == OpType.Explicit)
2351 Parent.MemberCache.CheckExistingMembersOverloads (this, GetMetadataName (OpType.Implicit), parameters);
2352 else if (OperatorType == OpType.Implicit)
2353 Parent.MemberCache.CheckExistingMembersOverloads (this, GetMetadataName (OpType.Explicit), parameters);
2355 TypeSpec declaring_type = Parent.CurrentType;
2356 TypeSpec return_type = MemberType;
2357 TypeSpec first_arg_type = ParameterTypes [0];
2359 TypeSpec first_arg_type_unwrap = first_arg_type;
2360 if (TypeManager.IsNullableType (first_arg_type))
2361 first_arg_type_unwrap = TypeManager.GetTypeArguments (first_arg_type) [0];
2363 TypeSpec return_type_unwrap = return_type;
2364 if (TypeManager.IsNullableType (return_type))
2365 return_type_unwrap = TypeManager.GetTypeArguments (return_type) [0];
2367 if (return_type == InternalType.Dynamic || first_arg_type == InternalType.Dynamic) {
2368 Report.Error (1964, Location,
2369 "User-defined operator `{0}' cannot convert to or from the dynamic type",
2370 GetSignatureForError ());
2376 // Rules for conversion operators
2378 if (OperatorType == OpType.Implicit || OperatorType == OpType.Explicit) {
2379 if (first_arg_type_unwrap == return_type_unwrap && first_arg_type_unwrap == declaring_type){
2380 Report.Error (555, Location,
2381 "User-defined operator cannot take an object of the enclosing type and convert to an object of the enclosing type");
2386 if (TypeManager.IsEqual (declaring_type, return_type) || declaring_type == return_type_unwrap) {
2387 conv_type = first_arg_type;
2388 } else if (TypeManager.IsEqual (declaring_type, first_arg_type) || declaring_type == first_arg_type_unwrap) {
2389 conv_type = return_type;
2391 Report.Error (556, Location,
2392 "User-defined conversion must convert to or from the enclosing type");
2397 // Because IsInterface and IsClass are not supported
2399 if (!TypeManager.IsGenericParameter (conv_type)) {
2400 if (conv_type.IsInterface) {
2401 Report.Error (552, Location, "User-defined conversion `{0}' cannot convert to or from an interface type",
2402 GetSignatureForError ());
2406 if (conv_type.IsClass) {
2407 if (TypeManager.IsSubclassOf (declaring_type, conv_type)) {
2408 Report.Error (553, Location, "User-defined conversion `{0}' cannot convert to or from a base class",
2409 GetSignatureForError ());
2413 if (TypeManager.IsSubclassOf (conv_type, declaring_type)) {
2414 Report.Error (554, Location, "User-defined conversion `{0}' cannot convert to or from a derived class",
2415 GetSignatureForError ());
2420 } else if (OperatorType == OpType.LeftShift || OperatorType == OpType.RightShift) {
2421 if (first_arg_type != declaring_type || parameters.Types[1] != TypeManager.int32_type) {
2422 Report.Error (564, Location, "Overloaded shift operator must have the type of the first operand be the containing type, and the type of the second operand must be int");
2425 } else if (parameters.Count == 1) {
2426 // Checks for Unary operators
2428 if (OperatorType == OpType.Increment || OperatorType == OpType.Decrement) {
2429 if (return_type != declaring_type && !TypeManager.IsSubclassOf (return_type, declaring_type)) {
2430 Report.Error (448, Location,
2431 "The return type for ++ or -- operator must be the containing type or derived from the containing type");
2434 if (first_arg_type != declaring_type) {
2436 559, Location, "The parameter type for ++ or -- operator must be the containing type");
2441 if (!TypeManager.IsEqual (first_arg_type_unwrap, declaring_type)){
2442 Report.Error (562, Location,
2443 "The parameter type of a unary operator must be the containing type");
2447 if (OperatorType == OpType.True || OperatorType == OpType.False) {
2448 if (return_type != TypeManager.bool_type){
2451 "The return type of operator True or False " +
2457 } else if (!TypeManager.IsEqual (first_arg_type_unwrap, declaring_type)) {
2458 // Checks for Binary operators
2460 var second_arg_type = ParameterTypes [1];
2461 if (TypeManager.IsNullableType (second_arg_type))
2462 second_arg_type = TypeManager.GetTypeArguments (second_arg_type) [0];
2464 if (!TypeManager.IsEqual (second_arg_type, declaring_type)) {
2465 Report.Error (563, Location,
2466 "One of the parameters of a binary operator must be the containing type");
2474 protected override bool ResolveMemberType ()
2476 if (!base.ResolveMemberType ())
2479 flags |= MethodAttributes.SpecialName | MethodAttributes.HideBySig;
2483 protected override MemberSpec FindBaseMember (out MemberSpec bestCandidate)
2485 // Operator cannot be override
2486 bestCandidate = null;
2490 public static string GetName (OpType ot)
2492 return names [(int) ot] [0];
2495 public static string GetName (string metadata_name)
2497 for (int i = 0; i < names.Length; ++i) {
2498 if (names [i] [1] == metadata_name)
2499 return names [i] [0];
2504 public static string GetMetadataName (OpType ot)
2506 return names [(int) ot] [1];
2509 public static string GetMetadataName (string name)
2511 for (int i = 0; i < names.Length; ++i) {
2512 if (names [i] [0] == name)
2513 return names [i] [1];
2518 public static OpType? GetType (string metadata_name)
2520 for (int i = 0; i < names.Length; ++i) {
2521 if (names[i][1] == metadata_name)
2528 public OpType GetMatchingOperator ()
2530 switch (OperatorType) {
2531 case OpType.Equality:
2532 return OpType.Inequality;
2533 case OpType.Inequality:
2534 return OpType.Equality;
2536 return OpType.False;
2539 case OpType.GreaterThan:
2540 return OpType.LessThan;
2541 case OpType.LessThan:
2542 return OpType.GreaterThan;
2543 case OpType.GreaterThanOrEqual:
2544 return OpType.LessThanOrEqual;
2545 case OpType.LessThanOrEqual:
2546 return OpType.GreaterThanOrEqual;
2552 public override string GetSignatureForError ()
2554 StringBuilder sb = new StringBuilder ();
2555 if (OperatorType == OpType.Implicit || OperatorType == OpType.Explicit) {
2556 sb.AppendFormat ("{0}.{1} operator {2}",
2557 Parent.GetSignatureForError (), GetName (OperatorType), type_expr.GetSignatureForError ());
2560 sb.AppendFormat ("{0}.operator {1}", Parent.GetSignatureForError (), GetName (OperatorType));
2563 sb.Append (parameters.GetSignatureForError ());
2564 return sb.ToString ();