Add OpenXmlElement.IsValidChild method

src/DocumentFormat.OpenXml.Framework/OpenXmlCompositeElement.cs

@@ -9,6 +9,7 @@
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.IO;
+using System.Linq;
 using System.Text;
 using System.Xml;
 
@@ -534,6 +535,21 @@ public override void RemoveAllChildren()
 
         #endregion
 
+        /// <summary>
+        /// Determines if the specified element is a valid child of the current element.
+        /// </summary>
+        /// <param name="element">The element to check.</param>
+        /// <returns>True if the specified element is a valid child; otherwise, false.</returns>
+        public override bool IsValidChild(OpenXmlElement element)
+        {
+            if (element is null)
+            {
+                return false;
+            }
+
+            return Metadata.Children.Elements.Any(el => el.Type.Name.Equals(element.Metadata.Type.Name));
+        }
+
         /// <summary>
         /// Saves all of the current node's children to the specified XmlWriter.
         /// </summary>

src/DocumentFormat.OpenXml.Framework/OpenXmlElement.cs

@@ -1330,6 +1330,16 @@ public bool IsBefore(OpenXmlElement element)
             return GetOrder(this, element) == ElementOrder.Before;
         }
 
+        /// <summary>
+        /// Determines if the specified element is a valid child of the current element.
+        /// </summary>
+        /// <param name="element">The element to check.</param>
+        /// <returns>True if the specified element is a valid child; otherwise, false.</returns>
+        public virtual bool IsValidChild(OpenXmlElement element)
+        {
+            return false;
+        }
+
         private enum ElementOrder
         {
             Same, // same element

src/DocumentFormat.OpenXml.Framework/PublicAPI/PublicAPI.Shipped.txt

@@ -1009,3 +1009,5 @@ DocumentFormat.OpenXml.OpenXmlPartWriterSettings.Encoding.set -> void
 DocumentFormat.OpenXml.OpenXmlPartWriterSettings.OpenXmlPartWriterSettings() -> void
 DocumentFormat.OpenXml.OpenXmlPartWriter.OpenXmlPartWriter(DocumentFormat.OpenXml.Packaging.OpenXmlPart! openXmlPart, DocumentFormat.OpenXml.OpenXmlPartWriterSettings! settings) -> void
 DocumentFormat.OpenXml.OpenXmlPartWriter.OpenXmlPartWriter(System.IO.Stream! partStream, DocumentFormat.OpenXml.OpenXmlPartWriterSettings! settings) -> void
+virtual DocumentFormat.OpenXml.OpenXmlElement.IsValidChild(DocumentFormat.OpenXml.OpenXmlElement! element) -> bool
+override DocumentFormat.OpenXml.OpenXmlCompositeElement.IsValidChild(DocumentFormat.OpenXml.OpenXmlElement! element) -> bool

test/DocumentFormat.OpenXml.Tests/ofapiTest/OpenXmlElementTest2.cs

@@ -8,7 +8,6 @@
 using DocumentFormat.OpenXml.Wordprocessing;
 using System;
 using System.IO;
-using System.Xml;
 using Xunit;
 
 namespace DocumentFormat.OpenXml.Tests
@@ -198,21 +197,6 @@ public void CanSetNullValue()
             Assert.Null(cell.Child);
         }
 
-        /// <summary>
-        /// A test for OpenXmlElement.GetOrAddFirstChild.
-        /// </summary>
-        [Fact]
-        public void GetOrAddFirstChildTest()
-        {
-            Paragraph p = new();
-            Run r = p.GetOrAddFirstChild<Run>();
-            Assert.NotNull(r);
-            Assert.Same(r, p.GetFirstChild<Run>());
-
-            var r2 = p.GetOrAddFirstChild<Run>();
-            Assert.Same(r, r2);
-        }
-
         private class WithChildElement : OpenXmlCompositeElement
         {
             public ChildElement Child
@@ -240,5 +224,61 @@ internal override void ConfigureMetadata(ElementMetadata.Builder builder)
                 builder.SetSchema(ElementType);
             }
         }
+
+        /// <summary>
+        /// A test for OpenXmlElement.GetOrAddFirstChild.
+        /// </summary>
+        [Fact]
+        public void GetOrAddFirstChildTest()
+        {
+            Paragraph p = new();
+            Run r = p.GetOrAddFirstChild<Run>();
+            Assert.NotNull(r);
+            Assert.Same(r, p.GetFirstChild<Run>());
+
+            var r2 = p.GetOrAddFirstChild<Run>();
+            Assert.Same(r, r2);
+        }
+
+        [Fact]
+        public void IsValidChild_ValidChild_ReturnsTrue()
+        {
+            // Arrange
+            Paragraph parentElement = new();
+            Run validChild = new();
+
+            // Act
+            bool result = parentElement.IsValidChild(validChild);
+
+            // Assert
+            Assert.True(result);
+        }
+
+        [Fact]
+        public void IsValidChild_InvalidChild_ReturnsFalse()
+        {
+            // Arrange
+            Paragraph parentElement = new();
+            Table invalidChild = new();
+
+            // Act
+            bool result = parentElement.IsValidChild(invalidChild);
+
+            // Assert
+            Assert.False(result);
+        }
+
+        [Fact]
+        public void IsValidChild_NullChild_ReturnsFalse()
+        {
+            // Arrange
+            Paragraph parentElement = new();
+
+            // Act
+            bool result = parentElement.IsValidChild(null);
+
+            // Assert
+            Assert.False(result);
+        }
     }
 }