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