Menggunakan Microsoft XML Serializer Generator di .NET

Dalam tutorial ini, Anda mempelajari cara menggunakan Microsoft XML Serializer Generator dalam aplikasi C#. Selama tutorial ini, Anda belajar:

Seperti Generator XML Serializer (sgen.exe) untuk .NET Framework, Microsoft.XmlSerializer.Generator NuGet package setara untuk .NET modern. Ini membuat assembly serialisasi XML untuk jenis yang terkandung dalam assembly guna meningkatkan performa startup serialisasi XML saat menserialisasikan atau mendeserialisasi objek dari jenis tersebut menggunakan XmlSerializer.

Prasyarat

Untuk menyelesaikan tutorial ini:

• .NET 8 SDK atau yang lebih baru.
• Editor kode favorit Anda.

Instruksi berikut menunjukkan kepada Anda cara menggunakan Generator Serializer XML di aplikasi konsol .NET.

Membuat aplikasi

1. Buka perintah dan buat folder bernama MyApp. Navigasi ke folder yang Anda buat dan ketik perintah berikut:

   dotnet new console
   

2. Tambahkan referensi ke paket Microsoft.XmlSerializer.Generator.

   dotnet add package Microsoft.XmlSerializer.Generator -v 10.0.0
   

   Setelah menjalankan perintah ini, baris berikut ditambahkan ke file proyek MyApp.csproj Anda:

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

3. Buka Program.cs di editor teks Anda. Tambahkan kelas bernama MyClass di Program.cs.

   public class MyClass
   {
      public int Value;
   }
   

4. Buat XmlSerializer untuk MyClass. Tambahkan baris berikut ke file Program.cs :

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

5. Bangun dan jalankan aplikasi. Jalankan aplikasi melalui dotnet run:

   dotnet run
   

   Aplikasi ini secara otomatis memuat dan menggunakan serializer yang telah dibuat sebelumnya pada runtime.

   Petunjuk / Saran

   dotnet run memanggil dotnet build untuk memastikan bahwa target build telah dilaksanakan, dan kemudian memanggil dotnet <assembly.dll> untuk menjalankan aplikasi target.

Jika semuanya berhasil, rakitan bernama MyApp.XmlSerializers.dll dihasilkan di folder output.

Selamat! Anda baru saja:

Kustomisasi rakitan serialisasi XML lebih lanjut (opsional)

Tambahkan XML berikut ke MyApp.csproj Anda untuk menyesuaikan pembuatan rakitan lebih lanjut:

<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>

Sumber daya terkait

• Memperkenalkan serialisasi XML
• Cara membuat serialisasi menggunakan XmlSerializer