.NET üzerinde Microsoft XML Seri Hale Getirici Oluşturucu kullanma

Bu öğreticide, C# uygulamasında Microsoft XML Seri Hale Getirici Oluşturucu'sunu kullanmayı öğreneceksiniz. Bu eğitimde öğrenecekleriniz:

  • .NET konsol uygulaması oluşturma
  • Microsoft.XmlSerializer.Generator paketine başvuru ekleme
  • Bağımlılık eklemek için MyApp.csproj'unuzu düzenleme
  • Sınıf ve XmlSerializer Nasıl Eklenir
  • Uygulamayı derleme ve çalıştırma

.NET Framework için XML Seri Hale Getirici Oluşturucu (sgen.exe) gibi Microsoft. XmlSerializer.Generator NuGet paketi modern .NET eşdeğerdir. kullanarak XmlSerializerbu türlerin nesnelerini seri hale getirerek veya seri durumdan çıkarırken XML serileştirmesinin başlatma performansını geliştirmek için bir derlemede bulunan türler için bir XML serileştirme derlemesi oluşturur.

Önkoşullar

Bu eğitimi tamamlamak için

  • .NET 8 SDK veya üzeri.
  • En sevdiğiniz kod düzenleyicisi.

Tavsiye

Kod düzenleyicisi yüklemeniz mi gerekiyor? Visual Studio'i deneyin.

Aşağıdaki yönergeler, bir .NET konsol uygulamasında XML Seri Hale Getirici Oluşturucu'nu nasıl kullanacağınızı gösterir.

Uygulamayı oluşturma

  1. Bir komut istemi açın ve MyApp adlı bir klasör oluşturun. Oluşturduğunuz klasöre gidin ve aşağıdaki komutu yazın:

    dotnet new console
    
  2. Microsoft.XmlSerializer.Generator paketine bir başvuru ekleyin.

    dotnet add package Microsoft.XmlSerializer.Generator -v 10.0.0
    

    Bu komut çalıştırıldıktan sonra MyApp.csproj proje dosyanıza aşağıdaki satırlar eklenir:

    <ItemGroup>
       <PackageReference Include="Microsoft.XmlSerializer.Generator" Version="10.0.0" />
    </ItemGroup>
    
  3. Metin düzenleyicinizde Program.cs açın. Program.csMyClass adlı bir sınıf ekleyin.

    public class MyClass
    {
       public int Value;
    }
    
  4. XmlSerializer için bir MyClass oluşturun. Program.cs dosyasına aşağıdaki satırı ekleyin:

    var serializer = new System.Xml.Serialization.XmlSerializer(typeof(MyClass));
    
  5. Uygulamayı derleyin ve çalıştırın. Uygulamayı dotnet run aracılığıyla çalıştırın.

    dotnet run
    

    Uygulama otomatik olarak yüklenir ve çalışma zamanında önceden oluşturulmuş seri hale getiricileri kullanır.

    Tavsiye

    dotnet run derleme hedeflerinin oluşturulduğundan emin olmak için çağrı dotnet build yapar ve ardından hedef uygulamayı çalıştırmak için çağrı dotnet <assembly.dll> yapar.

Önemli

Bu öğreticide uygulamanızı çalıştırmak için gösterilen komutlar ve adımlar yalnızca geliştirme zamanında kullanılır. Uygulamanızı dağıtmaya hazır olduğunuzda. .NET uygulamaları için farklı dağıtım stratejilerine ve komutuna dotnet publish göz atın.

Her şey başarılı olursa, çıkış klasöründe MyApp.XmlSerializers.dll adlı bir derleme oluşturulur.

Tebrikler! Az önce:

  • .NET konsol uygulaması oluşturuldu.
  • Microsoft.XmlSerializer.Generator paketine referans eklendi.
  • Bağımlılık eklemek için MyApp.csproj'unuzu düzenlediniz.
  • Bir sınıf ve XmlSerializer eklendi.
  • Uygulamayı derleyin ve çalıştırın.

XML serileştirme derlemesini daha fazla özelleştirin (isteğe bağlı)

Derleme oluşturmayı daha da özelleştirmek için MyApp.csproj dosyasına aşağıdaki XML'yi ekleyin:

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