Added support for retrieving the next batch of files in a large folder

Author: KoenZomers

Api/API.csproj

@@ -5,18 +5,18 @@
     <AssemblyName>KoenZomers.OneDrive.Api</AssemblyName>
     <SignAssembly>true</SignAssembly>
     <AssemblyOriginatorKeyFile>KoenZomers.OneDrive.Api.snk</AssemblyOriginatorKeyFile>
-    <Version>2.3.1.1</Version>
+    <Version>2.3.2.0</Version>
     <Authors>Koen Zomers</Authors>
     <Company>Koen Zomers</Company>
     <Description>API in .NET Standard 2.0, .NET Framework 4.5.2, .NET Framework 4.7.2 and .NET Core 2.0 to communicate with OneDrive Personal and OneDrive for Business</Description>
     <PackageProjectUrl>https://github.com/KoenZomers/OneDriveAPI</PackageProjectUrl>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-    <PackageReleaseNotes>- Fixed bug in using copy [Issue 24](https://github.com/KoenZomers/OneDriveAPI/issues/24)</PackageReleaseNotes>
+    <PackageReleaseNotes>- Added ```public virtual async Task&lt;OneDriveItemCollection&gt; GetNextChildrenByPath(string skipTokenUrl)``` which allows file requests from using i.e. ```public virtual async Task&lt;OneDriveItemCollection&gt; GetChildrenByPath(string path)``` on a large folder containing more than 100 files to retrieve the next batch of files. If your intend is to get all the results, use ```public virtual async Task&lt;OneDriveItem[]&gt; GetAllChildrenByPath(string path)``` instead. [Issue 28](https://github.com/KoenZomers/OneDriveAPI/issues/28)</PackageReleaseNotes>
     <PackageLicenseUrl>https://github.com/KoenZomers/OneDriveAPI/blob/master/LICENSE.md</PackageLicenseUrl>
     <Copyright>Koen Zomers</Copyright>
     <RootNamespace>KoenZomers.OneDrive.Api</RootNamespace>
-    <AssemblyVersion>2.3.1.1</AssemblyVersion>
-    <FileVersion>2.3.1.1</FileVersion>
+    <AssemblyVersion>2.3.2.0</AssemblyVersion>
+    <FileVersion>2.3.2.0</FileVersion>
   </PropertyGroup>
 
   <ItemGroup Condition=" '$(TargetFramework)' == 'net452' ">

Api/KoenZomers.OneDrive.Api.xml

@@ -354,7 +354,7 @@ public virtual async Task<OneDriveItem[]> GetAllDriveRootChildren()
         }
 
         /// <summary>
-        /// Retrieves the first batch of children under the provided OneDrive path
+        /// Retrieves the first batch of children under the provided OneDrive path. Use GetNextChildrenByPath and provide the NextLink from the results to fetch the next batch.
         /// </summary>
         /// <param name="path">Path within OneDrive to retrieve the child items of</param>
         /// <returns>OneDriveItemCollection containing the first batch of items in the requested folder</returns>
@@ -363,6 +363,16 @@ public virtual async Task<OneDriveItemCollection> GetChildrenByPath(string path)
             return await GetData<OneDriveItemCollection>(string.Concat("drive/root:/", path, ":/children"));
         }
 
+        /// <summary>
+        /// Retrieves a next batch of children using the provided full SkipToken path
+        /// </summary>
+        /// <param name="skipTokenUrl">Full URL from a NextLink in the response of a GetChildrenByPath request</param>
+        /// <returns>OneDriveItemCollection containing the next batch of items in the requested folder</returns>
+        public virtual async Task<OneDriveItemCollection> GetNextChildrenByPath(string skipTokenUrl)
+        {
+            return await GetData<OneDriveItemCollection>(skipTokenUrl);
+        }
+
         /// <summary>
         /// Retrieves all children under the provided OneDrive path
         /// </summary>

Api/OneDriveApi.cs

@@ -266,8 +266,14 @@ private string SelectLocalFile()
         /// </summary>
         private async void GetByPathButton_Click(object sender, EventArgs e)
         {            
-            var data = await OneDriveApi.GetChildrenByPath("Demo");
+            var data = await OneDriveApi.GetChildrenByPath("Test");
             JsonResultTextBox.Text = data != null ? data.OriginalJson : "Not available";
+
+            if (data.NextLink != null)
+            {
+                var nextData = await OneDriveApi.GetNextChildrenByPath(data.NextLink);
+                JsonResultTextBox.Text += nextData != null ? nextData.OriginalJson : "";
+            }            
         }
 
         /// <summary>

Demo/MainForm.cs

@@ -69,6 +69,10 @@ https://www.nuget.org/packages/KoenZomers.OneDrive.Api
 
 ## Version History
 
+2.3.2.0 - February 2, 2021
+
+- Added ```public virtual async Task<OneDriveItemCollection> GetNextChildrenByPath(string skipTokenUrl)``` which allows file requests from using i.e. ```public virtual async Task<OneDriveItemCollection> GetChildrenByPath(string path)``` on a large folder containing more than 100 files to retrieve the next batch of files. If your intend is to get all the results, use ```public virtual async Task<OneDriveItem[]> GetAllChildrenByPath(string path)``` instead. [Issue 28](https://github.com/KoenZomers/OneDriveAPI/issues/28)
+
 2.3.1.1 - November 16, 2020
 
 - Fixed bug in using copy [Issue 24](https://github.com/KoenZomers/OneDriveAPI/issues/24). Thanks to [Eirielson Rodrigues](https://github.com/eirielson) for reporting this!