Använd Microsoft XML-serialiserargenerator på .NET

I den här självstudien får du lära dig hur du använder Microsoft XML Serializer Generator i ett C#-program. Under den här självstudiekursen lär du dig:

Precis som XML Serializer Generator (sgen.exe) för .NET Framework, Microsoft. XmlSerializer.Generator NuGet-paketet motsvarar moderna .NET. Den skapar en XML-serialiseringssammansättning för typer som ingår i en sammansättning för att förbättra startprestandan för XML-serialisering vid serialisering eller deserialisering av objekt av dessa typer med hjälp XmlSerializerav .

Förutsättningar

För att slutföra den här handledningen:

• .NET 8 SDK eller senare.
• Din favoritkodredigerare.

Följande instruktioner visar hur du använder XML Serializer Generator i ett .NET konsolprogram.

Skapa appen

1. Öppna en kommandotolk och skapa en mapp med namnet MyApp. Gå till mappen du skapade och skriv följande kommando:

   dotnet new console
   

2. Lägg till en referens till paketet Microsoft.XmlSerializer.Generator.

   dotnet add package Microsoft.XmlSerializer.Generator -v 10.0.0
   

   När du har kört det här kommandot läggs följande rader till i projektfilen MyApp.csproj :

   <ItemGroup>
      <PackageReference Include="Microsoft.XmlSerializer.Generator" Version="10.0.0" />
   </ItemGroup>
   

3. Öppna Program.cs i textredigeraren. Lägg till en klass med namnet MyClass i Program.cs.

   public class MyClass
   {
      public int Value;
   }
   

4. Skapa en XmlSerializer för MyClass. Lägg till följande rad i filen Program.cs :

   var serializer = new System.Xml.Serialization.XmlSerializer(typeof(MyClass));
   

5. Skapa och kör programmet. Kör programmet via dotnet run:

   dotnet run
   

   Appen läser automatiskt in och använder förgenererade serialiserare under körning.

   Tips/Råd

   dotnet run anropar dotnet build för att säkerställa att byggmålen har skapats och anropar dotnet <assembly.dll> sedan för att köra målprogrammet.

Om allt lyckas genereras en sammansättning med namnet MyApp.XmlSerializers.dll i utdatamappen.

Grattis! Du har just:

Anpassa XML-serialiseringssammansättningen ytterligare (valfritt)

Lägg till följande XML i MyApp.csproj för att ytterligare anpassa sammansättningsgenereringen:

<PropertyGroup>
    <SGenReferences>C:\myfolder\abc.dll;C:\myfolder\def.dll</SGenReferences>
    <SGenTypes>MyApp.MyClass;MyApp.MyClass1</SGenTypes>
    <SGenProxyTypes>false</SGenProxyTypes>
    <SGenVerbose>true</SGenVerbose>
    <SGenKeyFile>mykey.snk</SGenKeyFile>
    <SGenDelaySign>true</SGenDelaySign>
</PropertyGroup>

Relaterade resurser

• Introduktion till XML-serialisering
• Serialisera med XmlSerializer