can get element contents

Author: mikeebowen

src/DocumentFormat.OpenXml.Framework/OpenXmlPartReader.cs

@@ -400,14 +400,120 @@ public override void Skip()
         #region Async methods
 #if TASKS_SUPPORTED
         public override Task<bool> ReadAsync()
+        {
+            return _xmlReader.ReadAsync();
+        }
+
+        public override Task<string> GetValueAsync()
         {
             ThrowIfObjectDisposed();
 
+            return _xmlReader.GetValueAsync();
+        }
 
-            return _xmlReader.ReadAsync();
+        public async override Task<bool> ReadFirstChildAsync()
+        {
+            ThrowIfObjectDisposed();
+
+            bool result = await MoveToFirstChildAsync().ConfigureAwait(true);
+
+            if (result && !ReadMiscNodes)
+            {
+                // skip miscellaneous node
+                while (result && IsMiscNode)
+                {
+                    result = MoveToNextSibling();
+                }
+            }
+
+            return result;
+        }
+
+        private async Task<bool> MoveToFirstChildAsync()
+        {
+            switch (_elementState)
+            {
+                case ElementState.EOF:
+                    return false;
+
+                case ElementState.Start:
+                    if (!(await _xmlReader.ReadAsync().ConfigureAwait(true)))
+                    {
+                        // should can read.
+                        Debug.Assert(false);
+                        return false;
+                    }
+
+                    GetElementInformation();
+                    if (_elementState == ElementState.End)
+                    {
+                        return false;
+                    }
+
+                    return true;
+
+                case ElementState.LeafStart:
+                    _elementState = ElementState.LeafEnd;
+                    return false;
+
+                case ElementState.End:
+                case ElementState.LeafEnd:
+                case ElementState.LoadEnd:
+                case ElementState.MiscNode:
+                    return false;
+
+                case ElementState.Null:
+                    ThrowIfNull();
+                    break;
+
+                default:
+                    break;
+            }
+
+            return false;
+        }
+
+        private async Task InnerSkipAsync()
+        {
+            switch (_elementState)
+            {
+                case ElementState.Null:
+                    ThrowIfNull();
+                    break;
+
+                case ElementState.EOF:
+                    return;
+
+                case ElementState.Start:
+                case ElementState.End:
+                case ElementState.MiscNode:
+                    _xmlReader.Skip();
+                    _elementStack.Pop();
+                    GetElementInformation();
+                    return;
+
+                case ElementState.LeafStart:
+                    // no move, just process cursor
+                    _elementStack.Pop();
+                    GetElementInformation();
+                    return;
+
+                case ElementState.LeafEnd:
+                case ElementState.LoadEnd:
+                    // cursor is leaf element, pop stack, no move
+                    _elementStack.Pop();
+                    GetElementInformation();
+                    return;
+
+                default:
+                    break;
+            }
+
+            return;
         }
 #endif
         #endregion
+
         #region private methods
 
         /// <summary>

src/DocumentFormat.OpenXml.Framework/OpenXmlReader.cs

@@ -256,6 +256,16 @@ public virtual Task<bool> ReadAsync()
         {
             return Task.FromResult(Read());
         }
+
+        public virtual Task<string> GetValueAsync()
+        {
+            return Task.FromResult(GetText());
+        }
+
+        public virtual Task<bool> ReadFirstChildAsync()
+        {
+            return Task.FromResult(ReadFirstChild());
+        }
         #endregion
 #endif
 

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

@@ -1,5 +1,8 @@
 #nullable enable
 DocumentFormat.OpenXml.OpenXmlPartReaderOptions.Async.get -> bool
 DocumentFormat.OpenXml.OpenXmlPartReaderOptions.Async.set -> void
+override DocumentFormat.OpenXml.OpenXmlPartReader.GetValueAsync() -> System.Threading.Tasks.Task<string!>!
 override DocumentFormat.OpenXml.OpenXmlPartReader.ReadAsync() -> System.Threading.Tasks.Task<bool>!
+virtual DocumentFormat.OpenXml.OpenXmlReader.GetValueAsync() -> System.Threading.Tasks.Task<string!>!
 virtual DocumentFormat.OpenXml.OpenXmlReader.ReadAsync() -> System.Threading.Tasks.Task<bool>!
+virtual DocumentFormat.OpenXml.OpenXmlReader.ReadFirstChildAsync() -> System.Threading.Tasks.Task<bool>!

src/DocumentFormat.OpenXml.Framework/XmlConvertingReader.cs

@@ -58,6 +58,8 @@ protected override void Dispose(bool disposing)
 
 #if TASKS_SUPPORTED
         public override Task<bool> ReadAsync() => BaseReader.ReadAsync();
+
+        public override Task<string> GetValueAsync() => BaseReader.GetValueAsync();
 #endif
 
         /// <inheritdoc/>