apiCount.include.md

@@ -1 +1 @@
-**API count: 299**
+**API count: 302**

api_list.include.md

@@ -380,6 +380,13 @@
  * `Boolean TryFormat(Span<Char>, Int32&, ReadOnlySpan<Char>, IFormatProvider)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.uint64.tryformat)
 
 
+#### Xml.Linq.XDocument
+
+ * `Task SaveAsync(Xml.XmlWriter, CancellationToken)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-xml-xmlwriter-system-threading-cancellationtoken))
+ * `Task SaveAsync(Stream, Xml.Linq.SaveOptions, CancellationToken)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-io-stream-system-xml-linq-saveoptions-system-threading-cancellationtoken))
+ * `Task SaveAsync(TextWriter, Xml.Linq.SaveOptions, CancellationToken)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-io-textwriter-system-xml-linq-saveoptions-system-threading-cancellationtoken))
+
+
 ### Static helpers
 
 #### EnumPolyfill

src/Consume/Consume.cs

@@ -18,6 +18,10 @@
 using System.Text.RegularExpressions;
 using System.Threading;
 using System.Threading.Tasks;
+using System.Xml;
+using System.Xml.Linq;
+using MemoryStream = System.IO.MemoryStream;
+
 #pragma warning disable CS4014
 
 class Consume
@@ -95,7 +99,7 @@ class Consume
         typeof(List<string>).IsAssignableTo(typeof(string));
         typeof(List<string>).IsAssignableTo(null);
 
-        var enumerable = (IEnumerable<string>)new List<string>
+        var enumerable = (IEnumerable<string>) new List<string>
         {
             "a",
             "b"
@@ -417,7 +421,7 @@ public void CollectionBuilderAttribute()
     public class MyCollection(ReadOnlySpan<int> initValues)
     {
         readonly int[] values = initValues.ToArray();
-        public IEnumerator<int> GetEnumerator() => ((IEnumerable<int>)values).GetEnumerator();
+        public IEnumerator<int> GetEnumerator() => ((IEnumerable<int>) values).GetEnumerator();
 
         public static MyCollection Create(ReadOnlySpan<int> values) => new(values);
     }
@@ -457,6 +461,14 @@ void GetMemberWithSameMetadataDefinitionAs(MemberInfo info)
         var result = typeof(string).GetMemberWithSameMetadataDefinitionAs(info);
     }
 
+    void XDocumentSaveAsync()
+    {
+        var document = new XDocument();
+        document.SaveAsync(new XmlTextWriter(null!), CancellationToken.None);
+        document.SaveAsync(new StringWriter(), SaveOptions.None, CancellationToken.None);
+        document.SaveAsync(new MemoryStream(), SaveOptions.None, CancellationToken.None);
+    }
+
 #if FeatureMemory
     void RandomNextBytesSpan()
     {

src/Directory.Build.props

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project>
   <PropertyGroup>
-    <Version>6.0.0</Version>
+    <Version>6.1.0</Version>
     <AssemblyVersion>1.0.0</AssemblyVersion>
     <PackageTags>Polyfill</PackageTags>
     <DisableImplicitNamespaceImports>true</DisableImplicitNamespaceImports>
@@ -18,6 +18,6 @@
     <NuGetAuditLevel>low</NuGetAuditLevel>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <IsAotCompatible
-      Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net8.0'))">true</IsAotCompatible>
+      Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net6.0'))">true</IsAotCompatible>    
   </PropertyGroup>
 </Project>

src/Directory.Packages.props

@@ -8,12 +8,12 @@
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
     <PackageVersion Include="Mono.Cecil" Version="0.11.5" />
     <PackageVersion Include="NUnit" Version="3.14.0" />
-    <PackageVersion Include="NUnit3TestAdapter" Version="4.5.0" />
-    <PackageVersion Include="ProjectDefaults" Version="1.0.131" />
-    <PackageVersion Include="SimpleInfoName" Version="2.2.0" />
+    <PackageVersion Include="NUnit3TestAdapter" Version="4.6.0" />
+    <PackageVersion Include="ProjectDefaults" Version="1.0.133" />
+    <PackageVersion Include="SimpleInfoName" Version="2.3.0" />
     <PackageVersion Include="System.Memory" Version="4.5.5" />
     <PackageVersion Include="System.Net.Http" Version="4.3.4" />
     <PackageVersion Include="System.Threading.Tasks.Extensions" Version="4.5.4" />
     <PackageVersion Include="System.ValueTuple" Version="4.5.0" />
   </ItemGroup>
-</Project>
+</Project>

src/Polyfill.sln

@@ -39,7 +39,7 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConsumeNoRefs", "ConsumeNoR
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConsumeTasksWithNoMemory", "ConsumeTasksWithNoMemory\ConsumeTasksWithNoMemory.csproj", "{96EF1E04-5862-4D9E-B800-A6402F1ADF7A}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TargetFrameowkUsage", "TargetFrameowkUsage\TargetFrameowkUsage.csproj", "{41CB5A0C-E0F5-4C5C-B2FC-9A289E8CFDF8}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TargetFrameworkUsage", "TargetFrameworkUsage\TargetFrameworkUsage.csproj", "{41CB5A0C-E0F5-4C5C-B2FC-9A289E8CFDF8}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

src/Polyfill.slnf

@@ -4,7 +4,7 @@
     "projects": [
       "Consume\\Consume.csproj",
       "Polyfill\\Polyfill.csproj",
-      "TargetFrameowkUsage\\TargetFrameowkUsage.csproj",
+      "TargetFrameworkUsage\\TargetFrameworkUsage.csproj",
       "Tests\\Tests.csproj"
     ]
   }

src/Polyfill/Polyfill_XDocument.cs

@@ -0,0 +1,83 @@
+// <auto-generated />
+#pragma warning disable
+
+#if NETFRAMEWORK || NETSTANDARD2_0
+
+using System;
+using System.Diagnostics.CodeAnalysis;
+using System.Xml;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Xml.Linq;
+using Link = System.ComponentModel.DescriptionAttribute;
+
+static partial class Polyfill
+{
+    /// <summary>
+    /// Output this <see cref="XDocument"/> to an <see cref="XmlWriter"/>.
+    /// </summary>
+    /// <param name="writer">
+    /// The <see cref="XmlWriter"/> to output the XML to.
+    /// </param>
+    /// <param name="cancellationToken">
+    /// A cancellation token.
+    /// </param>
+    [Link("https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-xml-xmlwriter-system-threading-cancellationtoken)")]
+    public static Task SaveAsync(
+        this XDocument target,
+        XmlWriter writer,
+        CancellationToken cancellationToken)
+    {
+        cancellationToken.ThrowIfCancellationRequested();
+        target.Save(writer);
+        return Task.CompletedTask;
+    }
+
+    /// <summary>
+    /// Output this <see cref="XDocument"/> to a <see cref="Stream"/>.
+    /// </summary>
+    /// <param name="stream">
+    /// The <see cref="Stream"/> to output the XML to.
+    /// </param>
+    /// <param name="options">
+    /// If SaveOptions.DisableFormatting is enabled the output is not indented.
+    /// If SaveOptions.OmitDuplicateNamespaces is enabled duplicate namespace declarations will be removed.
+    /// </param>
+    /// <param name="cancellationToken">A cancellation token.</param>
+    [Link("https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-io-stream-system-xml-linq-saveoptions-system-threading-cancellationtoken)")]
+    public static Task SaveAsync(
+        this XDocument target,
+        Stream stream,
+        SaveOptions options,
+        CancellationToken cancellationToken)
+    {
+        cancellationToken.ThrowIfCancellationRequested();
+        target.Save(stream, options);
+        return Task.CompletedTask;
+    }
+
+    /// <summary>
+    /// Output this <see cref="XDocument"/> to a <see cref="TextWriter"/>.
+    /// </summary>
+    /// <param name="textWriter">
+    /// The <see cref="TextWriter"/> to output the XML to.
+    /// </param>
+    /// <param name="options">
+    /// If SaveOptions.DisableFormatting is enabled the output is not indented.
+    /// If SaveOptions.OmitDuplicateNamespaces is enabled duplicate namespace declarations will be removed.
+    /// </param>
+    /// <param name="cancellationToken">A cancellation token.</param>
+    [Link("https://learn.microsoft.com/en-us/dotnet/api/system.xml.linq.xdocument.saveasync#system-xml-linq-xdocument-saveasync(system-io-textwriter-system-xml-linq-saveoptions-system-threading-cancellationtoken)")]
+    public static Task SaveAsync(
+        this XDocument target,
+        TextWriter textWriter,
+        SaveOptions options,
+        CancellationToken cancellationToken)
+    {
+        cancellationToken.ThrowIfCancellationRequested();
+        target.Save(textWriter, options);
+        return Task.CompletedTask;
+    }
+}
+#endif

src/Shared.sln.DotSettings

@@ -157,7 +157,6 @@
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_PATTERN_OP/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_FIRST_METHOD_CALL/@EntryValue">True</s:Boolean>
-	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_CHAINED_METHOD_CALLS/@EntryValue">CHOP_ALWAYS</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LINES/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_MULTIPLE_TYPE_PARAMEER_CONSTRAINTS_STYLE/@EntryValue">CHOP_ALWAYS</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/JavaScriptCodeFormatting/WRAP_LINES/@EntryValue">False</s:Boolean>

src/Tests/PolyfillTests_XDocument.cs

@@ -0,0 +1,40 @@
+using System.Xml;
+using System.Xml.Linq;
+
+partial class PolyfillTests
+{
+    [Test]
+    public async Task XDocumentSaveAsyncXmlWriter()
+    {
+        var document = GetXDocument();
+        var builder = new StringBuilder();
+        var settings = new XmlWriterSettings
+        {
+            OmitXmlDeclaration = true,
+            Indent = true,
+            Async = true
+        };
+
+        using var writer = XmlWriter.Create(builder, settings);
+        await document.SaveAsync(writer, Cancel.None);
+        await writer.FlushAsync();
+        Assert.AreEqual("<Child />", builder.ToString());
+    }
+
+    [Test]
+    public async Task XDocumentSaveAsyncStream()
+    {
+        var document = GetXDocument();
+        using var stream = new MemoryStream();
+
+        await document.SaveAsync(stream, SaveOptions.DisableFormatting, Cancel.None);
+        stream.Position = 0;
+        using var reader = new StreamReader(stream);
+        var result = await reader.ReadToEndAsync();
+
+        Assert.AreEqual("<?xml version=\"1.0\" encoding=\"utf-8\"?><Child />", result);
+    }
+
+    static XDocument GetXDocument() =>
+        new(new XElement("Child"));
+}