You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Fixed ElementArray not actually storing destub result
ElementArray.CopyTo now destubs
ImportElement no longer tries to claim an unowned Element if it would cause an ID collision
Changed ImportElement arguments to provide more flexibility
Bumped version number
/// Copies another Datamodel's <see cref="Element"/> into this one.
594
594
/// </summary>
595
-
/// <remarks>An imported Element will automatically replace any stub Elements which share its ID.</remarks>
595
+
/// <remarks>The return value will be owned by this Datamodel. It can be:
596
+
/// 1. foreign_element. This is the case when foreign_element has no owner and no Element with the same ID exists in this Datamodel.
597
+
/// 2. An existing Element owned by this Datamodel with the same ID as foreign_element.
598
+
/// 3. A copy of foreign_element. This is the case when foreign_element already had an owner and a corresponding Element was not found in this Datamodel.</remarks>
596
599
/// <param name="foreign_element">The Element to import. Must be owned by a different Datamodel.</param>
597
-
/// <param name="deep">Whether to import child Elements as well.</param>
598
-
/// <param name="overwrite">If true, foreign Elements will replace local stub Elements which share their ID. If false, the same foregin Elements will be skipped.</param>
599
-
/// <returns>A copy of the input Element owned by this Datamodel.</returns>
600
+
/// <param name="import_mode">How to respond when foreign_element references other foreign Elements.</param>
601
+
/// <param name="overwrite_mode">How to respond when the ID of a foreign Element is already in use in this Datamodel.</param>
602
+
/// <returns>foreign_element, a local Element, or a new copy of foreign_element. See Remarks for more details.</returns>
600
603
/// <exception cref="ArgumentNullException">Thrown if foreign_element is null.</exception>
601
604
/// <exception cref="ElementOwnershipException">Thrown if foreign_element is already owned by this Datamodel.</exception>
602
605
/// <exception cref="IndexOutOfRangeException">Thrown when the maximum number of Elements allowed in a Datamodel has been reached.</exception>
0 commit comments