Skip to content

Reinstate XML Serializer Generator tool tutorial#53395

Merged
gewarren merged 4 commits intodotnet:mainfrom
gewarren:sgen
Apr 28, 2026
Merged

Reinstate XML Serializer Generator tool tutorial#53395
gewarren merged 4 commits intodotnet:mainfrom
gewarren:sgen

Conversation

@gewarren
Copy link
Copy Markdown
Contributor

@gewarren gewarren commented Apr 27, 2026

Fixes #52693. Tool is not deprecated.

Updated tutorial to remove step to add DotNetCliToolReference item to project and tested it out.

Did run into an issue (related to dotnet/runtime#122719?) with package version 10.0.1, so kept package version at 10.0.0:

C:\Users\user.nuget\packages\microsoft.xmlserializer.generator\10.0.1\build\Microsoft.XmlSerializer.Generator.targets(51,5): warning MSB3073: The command "dotnet Microsoft.XmlSerializer.Generator "obj\Debug\net10.0\PreserializedApp.dll" --force --quiet obj\Debug\net10.0\sgen.rsp" exited with code 1.
C:\Users\user.nuget\packages\microsoft.xmlserializer.generator\10.0.1\build\Microsoft.XmlSerializer.Generator.targets(52,5): warning SGEN: Failed to generate the serializer for PreserializedApp.dll. Please follow the instructions at https://go.microsoft.com/fwlink/?linkid=858594 and try again.


Internal previews

📄 File 🔗 Preview link
docs/core/additional-tools/xml-serializer-generator.md Use Microsoft XML Serializer Generator on .NET
docs/navigate/tools-diagnostics/toc.yml docs/navigate/tools-diagnostics/toc
docs/standard/serialization/xml-serializer-generator-tool-sgen-exe.md XML Serializer Generator tool (Sgen.exe)

Copilot AI review requested due to automatic review settings April 27, 2026 19:00
@gewarren gewarren requested a review from a team as a code owner April 27, 2026 19:00
@dotnetrepoman dotnetrepoman Bot added this to the April 2026 milestone Apr 27, 2026
@gewarren gewarren requested a review from adegeo April 27, 2026 19:00
@gewarren gewarren enabled auto-merge (squash) April 27, 2026 19:00
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Reinstates and re-links a modern .NET tutorial for the XML Serializer Generator, and updates navigation to surface the content from the existing sgen.exe article.

Changes:

  • Updated the .NET Framework sgen.exe article to point to the modern .NET XML serializer generator tutorial.
  • Added a new modern .NET tutorial page for Microsoft.XmlSerializer.Generator.
  • Updated TOC navigation and removed an obsolete redirect entry for the new page.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 7 comments.

File Description
docs/standard/serialization/xml-serializer-generator-tool-sgen-exe.md Updates the note and “See also” to link to the modern .NET generator tutorial instead of a previous-versions page.
docs/navigate/tools-diagnostics/toc.yml Adds the new XML serializer generator tutorial to the “Additional tools” nav section.
docs/core/additional-tools/xml-serializer-generator.md Introduces a new tutorial for using Microsoft.XmlSerializer.Generator on modern .NET.
.openpublishing.redirection.core.json Removes a redirect that would conflict with (or hide) the new page path.

Comment thread docs/core/additional-tools/xml-serializer-generator.md
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Comment thread docs/standard/serialization/xml-serializer-generator-tool-sgen-exe.md Outdated
Comment thread docs/standard/serialization/xml-serializer-generator-tool-sgen-exe.md Outdated
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@adegeo adegeo disabled auto-merge April 28, 2026 18:44
Comment thread docs/core/additional-tools/xml-serializer-generator.md Outdated
@gewarren gewarren enabled auto-merge (squash) April 28, 2026 20:03
@gewarren gewarren merged commit 49a5fc4 into dotnet:main Apr 28, 2026
9 checks passed
@gewarren gewarren deleted the sgen branch April 28, 2026 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Link to deprecated (?) article?

3 participants