///--------------------------------------------------------------------------------
        /// <summary>This method assigns a value to a property, and updates corresponding
        /// forward and reverse engineering data.</summary>
        ///
        /// <param name="propertyName">The property name.</param>
        /// <param name="propertyValue">The property value.</param>
        ///--------------------------------------------------------------------------------
        public virtual bool AssignProperty(string propertyName, object propertyValue)
        {
            if (this.SetPropertyValue(propertyName, propertyValue) == true)
            {
                if (ReverseInstance == null)
                {
                    ReverseInstance = new MethodRelationship();
                    ReverseInstance.TransformDataFromObject(this, null, false);
                }
                else
                {
                    ReverseInstance.SetPropertyValue(propertyName, propertyValue);
                }
                if (ForwardInstance != null)
                {
                    this.TransformDataFromObject(ForwardInstance, null, false, true);
                }
            }
            else
            {
                return(false);
            }

            #region protected
            #endregion protected

            return(true);
        }
        ///--------------------------------------------------------------------------------
        /// <summary>This property returns a copy of the forward engineering data for the solution.</summary>
        ///--------------------------------------------------------------------------------
        public MethodRelationship GetForwardInstance(Solution forwardSolution)
        {
            bool isCustomized = false;
            MethodRelationship forwardItem = new MethodRelationship();

            if (ForwardInstance != null)
            {
                forwardItem.TransformDataFromObject(ForwardInstance, null, false);
                isCustomized = true;
            }
            else if (IsAutoUpdated == false)
            {
                forwardItem.TransformDataFromObject(this, null, false);
                isCustomized = true;
            }
            else
            {
                forwardItem.MethodRelationshipID = MethodRelationshipID;
            }
            if (isCustomized == false)
            {
                return(null);
            }
            forwardItem.SpecSourceName = DefaultSourceName;
            if (forwardSolution.ReferencedModelIDs.Find("ItemName", forwardItem.SpecSourceName) == null)
            {
                forwardSolution.ReferencedModelIDs.Add(CreateIDReference());
            }

            #region protected
            if (forwardItem.RelationshipID != Guid.Empty)
            {
                forwardItem.Relationship = Solution.RelationshipList.FindByID(forwardItem.RelationshipID);
                if (forwardItem.Relationship != null && forwardSolution.ReferencedModelIDs.Find("ItemName", forwardItem.Relationship.DefaultSourceName) == null)
                {
                    forwardSolution.ReferencedModelIDs.Add(forwardItem.Relationship.CreateIDReference());
                }
            }
            #endregion protected

            return(forwardItem);
        }
 ///--------------------------------------------------------------------------------
 /// <summary>This method adds a tag to TagList.</summary>
 ///--------------------------------------------------------------------------------
 public override void AddTag(string tagName)
 {
     if (ReverseInstance == null && IsAutoUpdated == true)
     {
         ReverseInstance = new MethodRelationship();
         ReverseInstance.TransformDataFromObject(this, null, false);
         IsAutoUpdated = false;
     }
     base.AddTag(tagName);
     if (ForwardInstance == null)
     {
         ForwardInstance = new MethodRelationship();
         ForwardInstance.MethodRelationshipID = MethodRelationshipID;
     }
     if (ForwardInstance.TagList.Find(t => t.TagName == tagName) == null)
     {
         ForwardInstance.TagList.Add(new Tag(Guid.NewGuid(), tagName));
     }
 }
 ///--------------------------------------------------------------------------------
 /// <summary>This method adds the current item to the solution, if it is valid
 /// and not already present in the solution.</summary>
 ///
 /// <param name="solutionContext">The associated solution.</param>
 /// <param name="templateContext">The associated template.</param>
 /// <param name="lineNumber">The line number of the associated statement.</param>
 ///--------------------------------------------------------------------------------
 public static void AddCurrentItemToSolution(Solution solutionContext, ITemplate templateContext, int lineNumber)
 {
     if (solutionContext.CurrentMethodRelationship != null)
     {
         string validationErrors = solutionContext.CurrentMethodRelationship.GetValidationErrors();
         if (!String.IsNullOrEmpty(validationErrors))
         {
             templateContext.LogException(solutionContext, solutionContext.CurrentMethodRelationship, validationErrors, lineNumber, InterpreterTypeCode.Output);
         }
         // link item to known id, solution, and parent
         solutionContext.CurrentMethodRelationship.Solution = solutionContext;
         solutionContext.CurrentMethodRelationship.AddToParent();
         MethodRelationship existingItem = solutionContext.MethodRelationshipList.Find(i => i.MethodRelationshipID == solutionContext.CurrentMethodRelationship.MethodRelationshipID);
         if (existingItem == null)
         {
             // add new item to solution
             solutionContext.CurrentMethodRelationship.AssignProperty("MethodRelationshipID", solutionContext.CurrentMethodRelationship.MethodRelationshipID);
             solutionContext.CurrentMethodRelationship.ReverseInstance.ResetModified(false);
             solutionContext.MethodRelationshipList.Add(solutionContext.CurrentMethodRelationship);
         }
         else
         {
             // update existing item in solution
             if (existingItem.Solution == null)
             {
                 existingItem.Solution = solutionContext;
             }
             if (existingItem.ForwardInstance == null && existingItem.IsAutoUpdated == false)
             {
                 existingItem.ForwardInstance = new MethodRelationship();
                 existingItem.ForwardInstance.TransformDataFromObject(existingItem, null, false);
             }
             existingItem.TransformDataFromObject(solutionContext.CurrentMethodRelationship, null, false);
             existingItem.AddToParent();
             existingItem.AssignProperty("MethodRelationshipID", existingItem.MethodRelationshipID);
             existingItem.ReverseInstance.ResetModified(false);
             solutionContext.CurrentMethodRelationship = existingItem;
         }
         #region protected
         #endregion protected
     }
 }