Freigeben über


SGen-Aufgabe

Erstellt eine XML-Serialisierungsassembly für Typen in der angegebenen Assembly. Diese Aufgabe umschließt das XML Serializer Generator-Tool (Sgen.exe). Weitere Informationen finden Sie unter XML Serializer Generator-Tool (Sgen.exe).

Parameter

In der folgenden Tabelle werden die Parameter der SGen-Aufgabe beschrieben.

Parameter

Beschreibung

BuildAssemblyName

Erforderlicher String-Parameter.

Die Assembly, für die Serialisierungscode generiert werden soll.

BuildAssemblyPath

Erforderlicher String-Parameter.

Der Pfad zur Assembly, für die Serialisierungscode generiert werden soll.

DelaySign

Optionaler Boolean-Parameter.

Der Wert true gibt an, dass die Assembly vollständig signiert werden soll. Der Wert false gibt an, dass Sie nur den öffentlichen Schlüssel in die Assembly einfügen möchten.

Dieser Parameter hat nur Auswirkungen, wenn er mit dem KeyFile-Parameter oder dem KeyContainer-Parameter verwendet wird.

KeyContainer

Optionaler String-Parameter.

Gibt einen Container an, der ein Schlüsselpaar enthält. Die Assembly wird signiert, indem ein öffentlicher Schlüssel in das Assemblymanifest eingefügt wird. Die Aufgabe signiert dann die endgültige Assembly mit dem privaten Schlüssel.

KeyFile

Optionaler String-Parameter.

Gibt ein Schlüsselpaar oder einen öffentlichen Schlüssel an, um damit eine Assembly zu signieren. Der Compiler fügt den öffentlichen Schlüssel in das Assemblymanifest ein und signiert anschließend die endgültige Assembly mit dem privaten Schlüssel.

Platform

Optionaler String-Parameter.

Ruft die Compiler-Plattform ab oder legt diese fest, die zum Generieren der Ausgabeassembly verwendet wird. Dieser Parameter kann den Wert x86, x64 oder anycpu aufweisen. Der Standardwert ist anycpu.

References

Optionaler String[]-Parameter.

Gibt die Assemblys an, auf die von den Typen, die XML-Serialisierung erfordern, verwiesen wird.

SdkToolsPath

Optionaler String-Parameter.

Gibt den Pfad zu den SDK-Tools, wie z. B. resgen.exe an.

SerializationAssembly

Optionaler ITaskItem[]-Ausgabeparameter.

Enthält die generierte Serialisierungsassembly.

SerializationAssemblyName

Optionaler String-Parameter.

Gibt den Namen der generierten Serialisierungsassembly an.

ShouldGenerateSerializer

Erforderlicher Boolean-Parameter.

Bei true generiert die SGen-Aufgabe eine Serialisierungsassembly.

Timeout

Optionaler Int32-Parameter.

Gibt die Zeit in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert lautet Int.MaxValue. Dieser gibt an, dass kein Timeoutintervall festgelegt ist.

ToolPath

Optionaler String-Parameter.

Gibt den Speicherort an, von dem die Aufgabe die zugrunde liegende ausführbare Datei (sgen.exe) lädt. Wird dieser Parameter nicht angegeben, verwendet die Aufgabe den SDK-Installationspfad für die Framework-Version, in der MSBuild ausgeführt wird.

Types

Optionaler String[]-Parameter.

Ruft eine Liste der spezifischen Typen zum Generieren des die Serialisierungscodes ab oder legt diese fest. SGen generiert Serialisierungscode nur für diese Typen.

UseProxyTypes

Erforderlicher Boolean-Parameter.

Beim Wert true generiert die SGen-Aufgabe nur Serialisierungscode für die Proxytypen des XML-Webdiensts.

Hinweise

Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der ToolTaskExtension-Klasse, die selbst von der ToolTask-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter ToolTaskExtension-Basisklasse.

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

MSBuild-Grundlagen