SGen görevi

  • Makale

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, x64veya anycpuolabilir. 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 trueayarlandığı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 trueayarlandığı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 trueayarlandığında bu görev, görevi yürütülürken düğümü verir.

Ayrıca bkz.