///--------------------------------------------------------------------------------
        /// <summary>This method is used to copy/paste a new item.</summary>
        ///
        /// <param name="copyItem">The item to copy/paste.</param>
        /// <param name="savePaste">Flag to determine whether to save the results of the paste.</param>
        ///--------------------------------------------------------------------------------
        public EntityReferenceViewModel PasteEntityReference(EntityReferenceViewModel copyItem, bool savePaste = true)
        {
            EntityReference newItem = new EntityReference();

            newItem.ReverseInstance = new EntityReference();
            newItem.TransformDataFromObject(copyItem.EntityReference, null, false);
            newItem.PropertyID    = Guid.NewGuid();
            newItem.IsAutoUpdated = false;

            newItem.Entity   = Entity;
            newItem.Solution = Solution;
            EntityReferenceViewModel newView = new EntityReferenceViewModel(newItem, Solution);

            newView.ResetModified(true);
            AddEntityReference(newView);

            // paste children
            if (savePaste == true)
            {
                Solution.EntityReferenceList.Add(newItem);
                Entity.EntityReferenceList.Add(newItem);
                newView.OnUpdated(this, null);
                Solution.ResetModified(true);
            }
            return(newView);
        }
 ///--------------------------------------------------------------------------------
 /// <summary>This method loads EntityReferences into the view model.</summary>
 ///
 /// <param name="entity">The entity to load.</param>
 /// <param name="solution">The associated solution.</param>
 /// <param name="loadChildren">Flag indicating whether to perform a deeper load.</param>
 ///--------------------------------------------------------------------------------
 public void LoadEntityReferences(Entity entity, Solution solution, bool loadChildren = true)
 {
     // attach the items
     Items.Clear();
     if (EntityReferences == null)
     {
         EntityReferences = new EnterpriseDataObjectList <EntityReferenceViewModel>();
     }
     if (loadChildren == true)
     {
         foreach (EntityReference item in entity.EntityReferenceList)
         {
             EntityReferenceViewModel itemView = new EntityReferenceViewModel(item, solution);
             itemView.Updated += new EventHandler(Children_Updated);
             EntityReferences.Add(itemView);
             Items.Add(itemView);
         }
     }
 }
 ///--------------------------------------------------------------------------------
 /// <summary>This method applies entityreference updates.</summary>
 ///--------------------------------------------------------------------------------
 public void ProcessEditEntityReferencePerformed(EntityReferenceEventArgs data)
 {
     try
     {
         bool isItemMatch = false;
         if (data != null && data.EntityReference != null)
         {
             foreach (EntityReferenceViewModel item in EntityReferences)
             {
                 if (item.EntityReference.PropertyID == data.EntityReference.PropertyID)
                 {
                     isItemMatch = true;
                     item.EntityReference.TransformDataFromObject(data.EntityReference, null, false);
                     item.OnUpdated(item, null);
                     item.ShowInTreeView();
                     break;
                 }
             }
             if (isItemMatch == false)
             {
                 // add new EntityReference
                 data.EntityReference.Entity = Entity;
                 EntityReferenceViewModel newItem = new EntityReferenceViewModel(data.EntityReference, Solution);
                 newItem.Updated += new EventHandler(Children_Updated);
                 EntityReferences.Add(newItem);
                 Entity.EntityReferenceList.Add(newItem.EntityReference);
                 Solution.EntityReferenceList.Add(newItem.EntityReference);
                 Items.Add(newItem);
                 OnUpdated(this, null);
                 newItem.ShowInTreeView();
             }
         }
     }
     catch (Exception ex)
     {
         ShowIssue(ex.Message + ex.StackTrace);
     }
 }
 ///--------------------------------------------------------------------------------
 /// <summary>This method deletes an instance of EntityReference from the view model.</summary>
 ///
 /// <param name="itemView">The EntityReference to delete.</param>
 ///--------------------------------------------------------------------------------
 public void DeleteEntityReference(EntityReferenceViewModel itemView)
 {
     itemView.Updated -= Children_Updated;
     EntityReferences.Remove(itemView);
     Delete(itemView);
 }
 ///--------------------------------------------------------------------------------
 /// <summary>This method adds an instance of EntityReference to the view model.</summary>
 ///
 /// <param name="itemView">The EntityReference to add.</param>
 ///--------------------------------------------------------------------------------
 public void AddEntityReference(EntityReferenceViewModel itemView)
 {
     itemView.Updated += new EventHandler(Children_Updated);
     EntityReferences.Add(itemView);
     Add(itemView);
 }