From ca2c33e06f0b9e5e560f0cbe02d4e5ee8fc63377 Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Tue, 30 Dec 2025 18:37:09 +0000 Subject: [PATCH 1/4] [DocsArchive-1.0.25349.1](2025-12-30-18-36-22)Auto archive content --- .openpublishing.redirection.json | 5 + .../xml-serializer-generator.md | 124 - docs/navigate/tools-diagnostics/toc.yml | 8345 ++++++++--------- 3 files changed, 4176 insertions(+), 4298 deletions(-) delete mode 100644 docs/core/additional-tools/xml-serializer-generator.md diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 2a1fac42e3233..551d5ab589b60 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,10 @@ { "redirections": [ + { + "source_path": "docs/core/additional-tools/xml-serializer-generator.md", + "redirect_url": "/previous-versions/dotnet/core/additional-tools/xml-serializer-generator", + "redirect_document_id": false + }, { "source_path": "docs/core/tools/dotnet-migrate.md", "redirect_url": "/previous-versions/dotnet/fundamentals/tools/dotnet-migrate", diff --git a/docs/core/additional-tools/xml-serializer-generator.md b/docs/core/additional-tools/xml-serializer-generator.md deleted file mode 100644 index 839ad497f2e75..0000000000000 --- a/docs/core/additional-tools/xml-serializer-generator.md +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: "Microsoft XML Serializer Generator" -description: An overview of the Microsoft XML Serializer Generator. Use the XML Serializer Generator to generate an XML serialization assembly for the types contained in your project. -author: honggit -ms.date: 04/23/2024 -ms.topic: tutorial -ms.custom: "mvc" ---- -# Use Microsoft XML Serializer Generator on .NET Core - -In this tutorial, you learn how to use the Microsoft XML Serializer Generator in a C# application. During the course of this tutorial, you learn: - -> [!div class="checklist"] -> -> - How to create a .NET console app -> - How to add a reference to the Microsoft.XmlSerializer.Generator package -> - How to edit your MyApp.csproj to add dependencies -> - How to add a class and an XmlSerializer -> - How to build and run the application - -Like the [Xml Serializer Generator (sgen.exe)](../../standard/serialization/xml-serializer-generator-tool-sgen-exe.md) for .NET Framework, the [Microsoft.XmlSerializer.Generator NuGet package](https://www.nuget.org/packages/Microsoft.XmlSerializer.Generator) is the equivalent for .NET Core/.NET 5+ and .NET Standard projects. It creates an XML serialization assembly for types contained in an assembly to improve the startup performance of XML serialization when serializing or de-serializing objects of those types using . - -## Prerequisites - -To complete this tutorial: - -- [.NET Core 2.1 SDK](https://dotnet.microsoft.com/download) or later. -- Your favorite code editor. - -> [!TIP] -> Need to install a code editor? Try [Visual Studio](https://aka.ms/vsdownload?utm_medium=microsoft&utm_source=learn.microsoft.com&utm_campaign=inline+link)! - -The following instructions show you how to use XML Serializer Generator in a .NET Core console application. - -## Create the app - -1. Open a command prompt and create a folder named *MyApp*. Navigate to the folder you created and type the following command: - - ```dotnetcli - dotnet new console - ``` - -2. Add a reference to the Microsoft.XmlSerializer.Generator package. - - ```dotnetcli - dotnet add package Microsoft.XmlSerializer.Generator -v 8.0.0 - ``` - - After running this command, the following lines are added to your *MyApp.csproj* project file: - - ```xml - - - - ``` - -3. Add a tool reference by adding the following `ItemGroup` section to your project file. - - ```xml - - - - ``` - -4. Open *Program.cs* in your text editor. Add a class named *MyClass* in *Program.cs*. - - ```csharp - public class MyClass - { - public int Value; - } - ``` - -5. Create an `XmlSerializer` for `MyClass`. Add the following line to the *Program.cs* file: - - ```csharp - var serializer = new System.Xml.Serialization.XmlSerializer(typeof(MyClass)); - ``` - -6. Build and run the application. Run the application via [`dotnet run`](../tools/dotnet-run.md): - - ```dotnetcli - dotnet run - ``` - - The app automatically loads and uses the pre-generated serializers at runtime. - - > [!TIP] - > [`dotnet run`](../tools/dotnet-run.md) calls [`dotnet build`](../tools/dotnet-build.md) to ensure that the build targets have been built, and then calls `dotnet ` to run the target application. - -> [!IMPORTANT] -> The commands and steps shown in this tutorial to run your application are used during development time only. Once you're ready to deploy your app, take a look at the different [deployment strategies](../deploying/index.md) for .NET apps and the [`dotnet publish`](../tools/dotnet-publish.md) command. - -If everything succeeds, an assembly named *MyApp.XmlSerializers.dll* is generated in the output folder. - -Congratulations! You have just: -> [!div class="checklist"] -> -> - Created a .NET console app. -> - Added a reference to the Microsoft.XmlSerializer.Generator package. -> - Edited your MyApp.csproj to add dependencies. -> - Added a class and an XmlSerializer. -> - Built and run the application. - -## Further customize XML serialization assembly (optional) - -Add the following XML to your *MyApp.csproj* to further customize assembly generation: - -```xml - - C:\myfolder\abc.dll;C:\myfolder\def.dll - MyApp.MyClass;MyApp.MyClass1 - false - true - mykey.snk - true - -``` - -## Related resources - -- [Introducing XML Serialization](../../standard/serialization/introducing-xml-serialization.md) -- [How to serialize using XmlSerializer (C#)](../../standard/linq/serialize-xmlserializer.md) -- [How to: Serialize Using XmlSerializer (Visual Basic)](../../standard/linq/serialize-xmlserializer.md) diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index ae5a32092278e..deaeba84d805e 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -1,4208 +1,4205 @@ items: - - name: .NET tools and diagnostics - href: index.yml - displayName: productivity,instrumentation - - name: .NET SDK +- name: .NET tools and diagnostics + displayName: productivity,instrumentation + href: index.yml +- name: .NET SDK + items: + - name: Overview + displayName: .net sdk,software development kit,software dev kit,tool + href: ../../core/sdk.md + - name: Environment variables + href: ../../core/tools/dotnet-environment-variables.md + - name: File-based apps + href: ../../core/sdk/file-based-apps.md + - name: dotnet-install scripts + href: ../../core/tools/dotnet-install-script.md + - name: global.json overview + href: ../../core/tools/global-json.md + - name: Telemetry + href: ../../core/tools/telemetry.md + - name: Signed-package verification + href: ../../core/tools/nuget-signed-package-verification.md + - name: Artifacts output layout + href: ../../core/sdk/artifacts-output.md + - name: Error messages items: - - name: Overview - displayName: ".net sdk,software development kit,software dev kit,tool" - href: ../../core/sdk.md - - name: Environment variables - href: ../../core/tools/dotnet-environment-variables.md - - name: File-based apps - href: ../../core/sdk/file-based-apps.md - - name: dotnet-install scripts - href: ../../core/tools/dotnet-install-script.md - - name: global.json overview - href: ../../core/tools/global-json.md - - name: Telemetry - href: ../../core/tools/telemetry.md - - name: Signed-package verification - href: ../../core/tools/nuget-signed-package-verification.md - - name: Artifacts output layout - href: ../../core/sdk/artifacts-output.md - - name: Error messages - items: - - name: NETSDK errors - items: - - name: List of NETSDK errors - href: ../../core/tools/sdk-errors/index.md - - name: NETSDK1004 - href: ../../core/tools/sdk-errors/netsdk1004.md - - name: NETSDK1005 and NETSDK1047 - href: ../../core/tools/sdk-errors/netsdk1005.md - - name: NETSDK1013 - href: ../../core/tools/sdk-errors/netsdk1013.md - - name: NETSDK1022 - href: ../../core/tools/sdk-errors/netsdk1022.md - - name: NETSDK1032 - href: ../../core/tools/sdk-errors/netsdk1032.md - - name: NETSDK1045 - href: ../../core/tools/sdk-errors/netsdk1045.md - - name: NETSDK1059 - href: ../../core/tools/sdk-errors/netsdk1059.md - - name: NETSDK1064 - href: ../../core/tools/sdk-errors/netsdk1064.md - - name: NETSDK1071 - href: ../../core/tools/sdk-errors/netsdk1071.md - - name: NETSDK1073 - href: ../../core/tools/sdk-errors/netsdk1073.md - - name: NETSDK1079 - href: ../../core/tools/sdk-errors/netsdk1079.md - - name: NETSDK1080 - href: ../../core/tools/sdk-errors/netsdk1080.md - - name: NETSDK1082 - href: ../../core/tools/sdk-errors/netsdk1082.md - - name: NETSDK1083 - href: ../../core/tools/sdk-errors/netsdk1083.md - - name: NETSDK1100 - href: ../../core/tools/sdk-errors/netsdk1100.md - - name: NETSDK1112 - href: ../../core/tools/sdk-errors/netsdk1112.md - - name: NETSDK1130 - href: ../../core/tools/sdk-errors/netsdk1130.md - - name: NETSDK1135 - href: ../../core/tools/sdk-errors/netsdk1135.md - - name: NETSDK1136 - href: ../../core/tools/sdk-errors/netsdk1136.md - - name: NETSDK1137 - href: ../../core/tools/sdk-errors/netsdk1137.md - - name: NETSDK1138 - href: ../../core/tools/sdk-errors/netsdk1138.md - - name: NETSDK1141 - href: ../../core/tools/sdk-errors/netsdk1141.md - - name: NETSDK1144 - href: ../../core/tools/sdk-errors/netsdk1144.md - - name: NETSDK1145 - href: ../../core/tools/sdk-errors/netsdk1145.md - - name: NETSDK1147 - href: ../../core/tools/sdk-errors/netsdk1147.md - - name: NETSDK1149 - href: ../../core/tools/sdk-errors/netsdk1149.md - - name: NETSDK1174 - href: ../../core/tools/sdk-errors/netsdk1174.md - - name: NETSDK1182 - href: ../../core/tools/sdk-errors/netsdk1182.md - - name: NETSDK1195 - href: ../../core/tools/sdk-errors/netsdk1195.md - - name: NETSDK1202 - href: ../../core/tools/sdk-errors/netsdk1202.md - - name: NETSDK1206 - href: ../../core/tools/sdk-errors/netsdk1206.md - - name: BuildCheck rules - items: - - name: Index of rules - href: ../../core/tools/buildcheck-rules/index.md - - name: BC0101 - href: ../../core/tools/buildcheck-rules/bc0101.md - - name: BC0102 - href: ../../core/tools/buildcheck-rules/bc0102.md - - name: .NET CLI + - name: NETSDK errors + items: + - name: List of NETSDK errors + href: ../../core/tools/sdk-errors/index.md + - name: NETSDK1004 + href: ../../core/tools/sdk-errors/netsdk1004.md + - name: NETSDK1005 and NETSDK1047 + href: ../../core/tools/sdk-errors/netsdk1005.md + - name: NETSDK1013 + href: ../../core/tools/sdk-errors/netsdk1013.md + - name: NETSDK1022 + href: ../../core/tools/sdk-errors/netsdk1022.md + - name: NETSDK1032 + href: ../../core/tools/sdk-errors/netsdk1032.md + - name: NETSDK1045 + href: ../../core/tools/sdk-errors/netsdk1045.md + - name: NETSDK1059 + href: ../../core/tools/sdk-errors/netsdk1059.md + - name: NETSDK1064 + href: ../../core/tools/sdk-errors/netsdk1064.md + - name: NETSDK1071 + href: ../../core/tools/sdk-errors/netsdk1071.md + - name: NETSDK1073 + href: ../../core/tools/sdk-errors/netsdk1073.md + - name: NETSDK1079 + href: ../../core/tools/sdk-errors/netsdk1079.md + - name: NETSDK1080 + href: ../../core/tools/sdk-errors/netsdk1080.md + - name: NETSDK1082 + href: ../../core/tools/sdk-errors/netsdk1082.md + - name: NETSDK1083 + href: ../../core/tools/sdk-errors/netsdk1083.md + - name: NETSDK1100 + href: ../../core/tools/sdk-errors/netsdk1100.md + - name: NETSDK1112 + href: ../../core/tools/sdk-errors/netsdk1112.md + - name: NETSDK1130 + href: ../../core/tools/sdk-errors/netsdk1130.md + - name: NETSDK1135 + href: ../../core/tools/sdk-errors/netsdk1135.md + - name: NETSDK1136 + href: ../../core/tools/sdk-errors/netsdk1136.md + - name: NETSDK1137 + href: ../../core/tools/sdk-errors/netsdk1137.md + - name: NETSDK1138 + href: ../../core/tools/sdk-errors/netsdk1138.md + - name: NETSDK1141 + href: ../../core/tools/sdk-errors/netsdk1141.md + - name: NETSDK1144 + href: ../../core/tools/sdk-errors/netsdk1144.md + - name: NETSDK1145 + href: ../../core/tools/sdk-errors/netsdk1145.md + - name: NETSDK1147 + href: ../../core/tools/sdk-errors/netsdk1147.md + - name: NETSDK1149 + href: ../../core/tools/sdk-errors/netsdk1149.md + - name: NETSDK1174 + href: ../../core/tools/sdk-errors/netsdk1174.md + - name: NETSDK1182 + href: ../../core/tools/sdk-errors/netsdk1182.md + - name: NETSDK1195 + href: ../../core/tools/sdk-errors/netsdk1195.md + - name: NETSDK1202 + href: ../../core/tools/sdk-errors/netsdk1202.md + - name: NETSDK1206 + href: ../../core/tools/sdk-errors/netsdk1206.md + - name: BuildCheck rules + items: + - name: Index of rules + href: ../../core/tools/buildcheck-rules/index.md + - name: BC0101 + href: ../../core/tools/buildcheck-rules/bc0101.md + - name: BC0102 + href: ../../core/tools/buildcheck-rules/bc0102.md +- name: .NET CLI + items: + - name: Overview + displayName: .net cli,command-line interface,cli,tool + href: ../../core/tools/index.md + - name: dotnet command reference + items: + - name: dotnet + href: ../../core/tools/dotnet.md + - name: dotnet build + href: ../../core/tools/dotnet-build.md + - name: dotnet build-server + href: ../../core/tools/dotnet-build-server.md + - name: dotnet clean + href: ../../core/tools/dotnet-clean.md + - name: dotnet dev-certs + href: ../../core/tools/dotnet-dev-certs.md + - name: dotnet format + href: ../../core/tools/dotnet-format.md + - name: dotnet help + href: ../../core/tools/dotnet-help.md + - name: dotnet msbuild + href: ../../core/tools/dotnet-msbuild.md + - name: dotnet new + items: + - name: dotnet new