SGen görevi
Belirtilen derlemedeki türler için bir XML serileştirme derlemesi oluşturur. Bu görev XML Seri Hale Getirici Oluşturucu aracını (Sgen.exe) sarmalar. Daha fazla bilgi için bkz . XML Seri Hale Getirici Oluşturucu aracı (Sgen.exe).
Parametreler
Aşağıdaki tabloda görevin parametreleri SGen
açıklanmaktadır.
Parametre | Tanım |
---|---|
BuildAssemblyName |
Gerekli String parametresi.Için serileştirme kodu oluşturulacak derleme. |
BuildAssemblyPath |
Gerekli String parametresi.için serileştirme kodu oluşturulacak derlemenin yolu. |
DelaySign |
İsteğe bağlı Boolean parametre.ise true , yalnızca ortak anahtarı derlemeye yerleştirmek istediğinizi belirtir. ise false , tam olarak imzalanan bir derleme istediğinizi belirtir.Veya KeyContainer parametresiyle kullanılmadığı sürece bu parametrenin KeyFile hiçbir etkisi yoktur. |
KeyContainer |
İsteğe bağlı String parametre.Anahtar çifti içeren bir kapsayıcıyı belirtir. Bu, derleme bildirimine ortak anahtar ekleyerek derlemeyi imzalar. Görev daha sonra son derlemeyi özel anahtarla imzalar. |
KeyFile |
İsteğe bağlı String parametre.Bir derlemeyi imzalamak için kullanılacak bir anahtar çifti veya ortak anahtar belirtir. Derleyici ortak anahtarı derleme bildirimine ekler ve ardından son derlemeyi özel anahtarla imzalar. |
Platform |
İsteğe bağlı String parametre.Çıkış derlemesini oluşturmak için kullanılan Derleyici Platformunu alır veya ayarlar. Bu parametrenin değeri x86 , x64 veya anycpu olabilir. Varsayılan anycpu değeridir. |
References |
İsteğe bağlı String[] parametre.XML serileştirme gerektiren türleri tarafından başvurulan bir derleme belirtir. |
SdkToolsPath |
İsteğe bağlı String parametre.Resgen.exe gibi SDK araçlarının yolunu belirtir. |
SerializationAssembly |
İsteğe bağlı ITaskItem[] çıkış parametresi.Oluşturulan serileştirme derlemesini içerir. |
SerializationAssemblyName |
İsteğe bağlı String parametre.Oluşturulan serileştirme derlemesinin adını belirtir. |
ShouldGenerateSerializer |
Gerekli Boolean parametresi.ise true , SGen görevi bir serileştirme derlemesi oluşturmalıdır. |
Timeout |
İsteğe bağlı Int32 parametre.Görev yürütülebilir dosyasının sonlandırıldığı süreyi milisaniye cinsinden belirtir. Varsayılan değer, zaman aşımı süresi olmadığını belirten değeridir Int.MaxValue . |
ToolPath |
İsteğe bağlı String parametre.Görevin temel alınan yürütülebilir dosyayı (sgen.exe) yükleyeceği konumu belirtir. Bu parametre belirtilmezse, görev MSBuild çalıştıran çerçevenin sürümüne karşılık gelen SDK yükleme yolunu kullanır. |
Types |
İsteğe bağlı String[] parametre.Serileştirme kodu oluşturmak için belirli Türlerin listesini alır veya ayarlar. SGen yalnızca bu türler için serileştirme kodu oluşturur. |
UseProxyTypes |
Gerekli Boolean parametresi.ise true , SGen görevi yalnızca XML Web hizmeti proxy türleri için serileştirme kodu oluşturur. |
ToolTaskExtension parametreleri
Bu görev, sınıfından ToolTaskExtension devralan sınıfından ToolTask devralır ve sınıfından Task devralır. Bu devralma zinciri, görevlerden türetilen görevlere birkaç parametre ekler.
Aşağıdaki tabloda temel sınıfların parametreleri açıklanmaktadır:
Parametre | Tanım |
---|---|
EchoOff | İsteğe bağlı bool parametre.olarak true ayarlandığında, bu görev komut satırının stdout'a kopyalanmaması için cmd.exe komut satırına /Q geçirir. |
EnvironmentVariables | İsteğe bağlı String dizi parametresi.Ortam değişkeni tanımlarının noktalı virgülle ayrılmış dizisi. Her tanım, eşittir işaretiyle ayrılmış bir ortam değişkeni adı ve değeri belirtmelidir. Bu değişkenler, normal ortam bloğuna ek olarak veya seçmeli olarak geçersiz kılmaya ek olarak oluşturulan yürütülebilir dosyaya geçirilir. Örneğin, Variable1=Value1;Variable2=Value2 . |
ExitCode | İsteğe bağlı Int32 çıkış salt okunur parametresi.Yürütülen komut tarafından sağlanan çıkış kodunu belirtir. Görev herhangi bir hata günlüğe kaydetmişse ancak işlem 0 çıkış koduna (başarılı) sahipse, bu -1 olarak ayarlanır. |
LogStandardErrorAsError | İsteğe bağlı bool parametre.ise true , standart hata akışında alınan tüm iletiler hata olarak günlüğe kaydedilir. |
StandardErrorImportance | İsteğe bağlı String parametre.Standart hata akışındaki metnin günlüğe kaydedildiği önem. |
StandardOutputImportance | İsteğe bağlı String parametre.Standart çıkış akışındaki metnin günlüğe kaydedildiği önem. |
Timeout | İsteğe bağlı Int32 parametre.Görev yürütülebilir dosyasının sonlandırıldığı süreyi milisaniye cinsinden belirtir. Varsayılan değer, zaman aşımı süresi olmadığını belirten değeridir Int.MaxValue . Zaman aşımı milisaniye cinsindendir. |
ToolExe | İsteğe bağlı string parametre.Projeler bir ToolName'i geçersiz kılmak için bunu uygulayabilir. Görevler ToolName'i korumak için bunu geçersiz kılabilir. |
ToolPath | İsteğe bağlı string parametre.Görevin temel alınan yürütülebilir dosyayı yüklediği konumu belirtir. Bu parametre belirtilmezse, görev MSBuild çalıştıran çerçevenin sürümüne karşılık gelen SDK yükleme yolunu kullanır. |
UseCommandProcessor | İsteğe bağlı bool parametre.olarak true ayarlandığında, bu görev komut satırı için bir toplu iş dosyası oluşturur ve komutu doğrudan yürütmek yerine komut işlemcisini kullanarak yürütür. |
YieldDuringToolExecution | İsteğe bağlı bool parametre.olarak true ayarlandığında bu görev, görevi yürütülürken düğümü verir. |