Tugas SGen

Membuat rakitan serialisasi XML untuk jenis dalam rakitan yang ditentukan. Tugas ini membungkus alat XML Serializer Generator (Sgen.exe). Untuk informasi selengkapnya, lihat Alat XML Serializer Generator (Sgen.exe).

Parameter

Tabel berikut ini menjelaskan parameter tugas SGen.

Parameter	Deskripsi
BuildAssemblyName	Parameter String wajib. Rakitan untuk menghasilkan kode serialisasi.
BuildAssemblyPath	Parameter String wajib. Jalur ke rakitan untuk menghasilkan kode serialisasi.
DelaySign	Parameter Boolean opsional. Jika true, menentukan bahwa Anda hanya ingin menempatkan kunci umum di rakitan. Jika false, menentukan bahwa Anda menginginkan rakitan yang ditandatangani sepenuhnya. Parameter ini tidak berpengaruh kecuali digunakan dengan parameter KeyFile atau KeyContainer.
KeyContainer	Parameter String opsional. Menentukan kontainer yang menampung pasangan kunci. Ini akan menandatangani rakitan dengan memasukkan kunci umum ke dalam manifes rakitan. Tugas kemudian akan menandatangani rakitan akhir dengan kunci privat.
KeyFile	Parameter String opsional. Menentukan pasangan kunci atau kunci umum yang akan digunakan untuk menandatangani rakitan. Pengompilasi menyisipkan kunci umum dalam manifes assembly lalu menandatangani assembly akhir dengan kunci privat.
Platform	Parameter String opsional. Mendapatkan atau Mengatur Platform Kompilator yang digunakan untuk menghasilkan rakitan output. Parameter ini dapat memiliki nilai x86, x64, atau anycpu. Defaultnya adalah anycpu.
References	Parameter String[] opsional. Menentukan rakitan yang direferensikan oleh jenis yang membutuhkan serialisasi XML.
SdkToolsPath	Parameter String opsional. Menentukan jalur ke alat SDK, seperti resgen.exe.
SerializationAssembly	Parameter output ITaskItem[] opsional. Berisi rakitan serialisasi yang dihasilkan.
SerializationAssemblyName	Parameter String opsional. Menentukan nama rakitan serialisasi yang dihasilkan.
ShouldGenerateSerializer	Parameter Boolean wajib. Jika true, tugas SGen harus menghasilkan rakitan serialisasi.
Timeout	Parameter Int32 opsional. Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis.
ToolPath	Parameter String opsional. Menentukan lokasi dari mana tugas akan memuat file yang dapat dijalankan yang mendasarinya (sgen.exe). Jika parameter ini tidak ditentukan, tugas akan menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild.
Types	Parameter String[] opsional. Mendapatkan atau mengatur daftar Jenis tertentu untuk menghasilkan kode serialisasi. SGen akan menghasilkan kode serialisasi hanya untuk jenis tersebut.
UseProxyTypes	Parameter Boolean wajib. Jika true, tugas SGen menghasilkan kode serialisasi hanya untuk jenis proksi layanan Web XML.

Parameter ToolTaskExtension

Tugas ini mewarisi dari kelas ToolTaskExtension, yang mewarisi dari kelas ToolTask, yang mewarisi dari Task kelas itu sendiri. Rantai pewarisan ini menambahkan beberapa parameter ke tugas yang berasal dari tugas itu sendiri.

Tabel berikut ini menjelaskan parameter kelas dasar:

Parameter	Deskripsi
EchoOff	Parameter bool opsional. Ketika diatur ke true, tugas ini meneruskan /Q ke baris perintahcmd.exe, sehingga baris perintah tidak disalin ke stdout.
EnvironmentVariables	Parameter array String opsional. Array definisi variabel lingkungan, dipisahkan oleh titik koma. Setiap definisi harus menentukan nama dan nilai variabel lingkungan yang dipisahkan oleh tanda sama dengan. Variabel-variabel ini diteruskan ke yang dapat dijalankan yang dihasilkan selain, atau secara selektif mengambil alih, blok lingkungan reguler. Misalnya, Variable1=Value1;Variable2=Value2.
ExitCode	Parameter baca-saja output Int32 opsional. Tentukan kode keluar yang disediakan oleh perintah yang dijalankan. Jika tugas mencatat kesalahan apa pun, tetapi prosesnya memiliki kode keluar 0 (berhasil), ini diatur ke -1.
LogStandardErrorAsError	Parameter bool opsional. Jika true, semua pesan yang diterima pada aliran kesalahan standar dicatat sebagai kesalahan.
StandardErrorImportance	Parameter String opsional. Pentingnya untuk mencatat teks dari aliran kesalahan standar.
StandardOutputImportance	Parameter String opsional. Pentingnya untuk mencatat teks dari aliran keluar standar.
Timeout	Parameter Int32 opsional. Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis. Waktu habis dalam milidetik.
ToolExe	Parameter string opsional. Proyek dapat menerapkan ini untuk mengambil alih ToolName. Tugas dapat mengambil alih ini untuk mempertahankan ToolName.
ToolPath	Parameter string opsional. Tentukan lokasi dari mana tugas memuat file eksekusi yang mendasarinya. Jika parameter ini tidak ditentukan, tugas menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild.
UseCommandProcessor	Parameter bool opsional. Saat diatur ke true, tugas ini membuat file batch untuk baris perintah dan menjalankannya dengan menggunakan prosesor perintah alih-alih menjalankan perintah secara langsung.
YieldDuringToolExecution	Parameter bool opsional. Saat diatur ke true, tugas ini menghasilkan node saat tugasnya dijalankan.

Baca juga

• Referensi tugas
• Tugas
• Konsep MSBuild