XML Serializer Generator (Sgen.exe)

Generator Serializer XML membuat rakitan serialisasi XML untuk jenis dalam rakitan tertentu. Perakitan serialisasi meningkatkan performa startup XmlSerializer ketika menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan.

Nota

Alat ini khusus untuk rakitan .NET Framework. Untuk menghasilkan serializer XML untuk rakitan .NET (Core), lihat Gunakan Microsoft XML Serializer Generator di .NET Core.

Sintaksis

Jalankan alat dari baris perintah.

sgen [options]

Petunjuk / Saran

Agar alat .NET Framework berfungsi dengan baik, Anda harus menggunakan Perintah Pengembang Visual Studio atau Visual Studio Developer PowerShell atau mengatur Pathvariabel lingkungan , Include, dan Lib dengan benar. Untuk mengatur variabel lingkungan ini, jalankan SDKVars.bat, yang terletak di <direktori SDK>\version<\>Bin.

Parameter-parameternya

Opsi Deskripsi
/a[ssembly]:filename Menghasilkan kode serialisasi untuk semua jenis yang terkandung dalam rakitan atau dapat dieksekusi yang ditentukan oleh nama file. Hanya satu nama file yang dapat disediakan. Jika argumen ini diulang, nama file terakhir digunakan.
/c[ompiler]:options Menentukan opsi untuk diteruskan ke pengkompilasi C#. Semua opsi csc.exe didukung saat diteruskan ke pengkompilasi. Ini dapat digunakan untuk menentukan bahwa assembly harus ditandatangani dan untuk menentukan file kunci.
/d[ebug] Menghasilkan citra yang dapat digunakan dengan debugger.
/f[orce] Memaksa penimpaan rakitan yang ada dengan nama yang sama. Defaultnya adalah false.
/help atau /? Menampilkan sintaks perintah dan opsi untuk alat ini.
/k[eep] Mencegah penghapusan file sumber yang dihasilkan dan file sementara lainnya setelah dikompilasi ke dalam assembly serialisasi. Ini dapat digunakan untuk menentukan apakah alat menghasilkan kode serialisasi untuk jenis tertentu.
/n[ologo] Menyembunyikan tampilan banner startup Microsoft.
/o[ut]:path Menentukan direktori untuk menyimpan rakitan yang dihasilkan. Nota: Nama rakitan yang dihasilkan terdiri dari nama rakitan input ditambah "xmlSerializers.dll".
/p[roxytypes] Menghasilkan kode serialisasi hanya untuk jenis proksi layanan Web XML.
/r[eference]:assemblyfiles Menentukan rakitan yang direferensikan oleh jenis yang memerlukan serialisasi XML. Menerima beberapa file rakitan yang dipisahkan oleh koma.
/s[ilent] Menyembunyikan tampilan pesan berhasil.
/t[ype]:type Menghasilkan kode serialisasi hanya untuk jenis yang ditentukan.
/v[erbose] Menampilkan output verbose untuk penelusuran kesalahan. Mencantumkan jenis dari rakitan target yang tidak dapat diserialisasikan dengan XmlSerializer.
/? Menampilkan sintaks perintah dan opsi untuk alat ini.

Komentar

Ketika Generator Serializer XML tidak digunakan, XmlSerializer menghasilkan kode serialisasi dan rakitan serialisasi untuk setiap jenis setiap kali aplikasi dijalankan. Untuk meningkatkan performa startup serialisasi XML, gunakan alat Sgen.exe untuk menghasilkan rakitan tersebut terlebih dahulu. Komponen ini kemudian dapat disebarkan bersama aplikasi.

Generator Serialisasi XML juga dapat meningkatkan performa klien yang menggunakan proksi layanan web XML untuk berkomunikasi dengan server, karena proses serialisasi tidak akan mempengaruhi performa saat tipe dimuat pertama kali.

Rakitan yang dihasilkan tidak dapat digunakan di sisi server layanan web. Alat ini hanya untuk klien layanan web dan skenario serialisasi manual.

Nota

Alat sgen ini tidak kompatibel dengan setter khusus init . Alat ini akan gagal jika rakitan target berisi properti publik yang menggunakan fitur ini.

Penamaan

Jika rakitan yang berisi jenis yang akan diserialisasikan diberi nama MyType.dll, maka rakitan serialisasi terkait akan diberi nama MyType.XmlSerializers.dll.

Contoh

Perintah berikut membuat rakitan bernama Data.XmlSerializers.dll untuk menserialisasikan semua jenis yang terkandung dalam rakitan bernama Data.dll.

sgen Data.dll

Assembly Data.XmlSerializers.dll dapat dirujuk dari kode yang perlu menserialisasikan dan mendeserialisasi tipe pada Data.dll.

Lihat juga

  • Last updated on