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 der Assembly, für die Serialisierungscode generiert werden soll. |
DelaySign |
Optionaler Boolean-Parameter.Ist der Wert true, gibt dies an, dass Sie nur den öffentlichen Schlüssel in die Assembly platzieren möchten. Ist der Wert false, gibt dies an, dass die Assembly vollständig signiert werden soll.Dieser Parameter hat nur dann Auswirkungen, wenn Sie ihn entweder mit dem KeyFile- oder KeyContainer-Parameter verwenden. |
KeyContainer |
Optionaler String-Parameter.Gibt einen Container an, der ein Schlüsselpaar enthält. Dieser wird zum Signieren der Assembly verwendet, indem ein öffentlicher Schlüssel in das Assemblymanifest eingefügt wird. Dann wird die endgültige Assembly von der Aufgabe mit dem privaten Schlüssel signiert. |
KeyFile |
Optionaler String-Parameter.Gibt ein Schlüsselpaar oder einen öffentlichen Schlüssel an, das bzw. der zum Signieren einer Assembly verwendet werden soll. 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, die zum Generieren der Ausgabeassembly verwendet wird, oder legt sie fest. Dieser Parameter kann den Wert x86, x64 oder anycpu haben. 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.Legt den Pfad zu den SDK-Tools fest, wie z.B. resgen.exe. |
SerializationAssembly |
Optionaler ITaskItem[] -Ausgabeparameter.Enthält die generierte Serialisierungsassembly. |
SerializationAssemblyName |
Optionaler String-Parameter.Gibt den Namen der generierten Serialisierungsassembly an. |
ShouldGenerateSerializer |
Erforderlicher Boolean -Parameter.Wenn true, sollte die SGen-Aufgabe eine Serialisierungsassembly generieren. |
Timeout |
Optionaler Int32-Parameter.Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt. |
ToolPath |
Optionaler String-Parameter.Legt den Speicherort fest, von wo aus die Aufgabe die zugrunde liegende ausführbare Datei (sgen.exe) lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird. |
Types |
Optionaler String[]-Parameter.Ruft eine Liste der spezifischen Typen ab, für die Serialisierungscode generiert werden soll, oder legt sie fest. SGen generiert nur für diese Typen Serialisierungscode. |
UseProxyTypes |
Erforderlicher Boolean -Parameter.Wenn true, generiert die SGen-Aufgabe Serialisierungscode ausschließlich für die Proxytypen des XML-Webdiensts. |
ToolTaskExtension-Parameter
Dieser Task erbt aus der ToolTaskExtension-Klasse, die aus der ToolTask-Klasse erbt, welche wiederum aus der Task-Klasse erbt. Diese Vererbungskette fügt verschiedene Parameter zu den Aufgaben hinzu, die aus ihnen abgeleitet werden.
In der folgenden Tabelle werden die Parameter der Basisklassen beschrieben:
| Parameter | Beschreibung |
|---|---|
| EchoOff | Optionaler bool-Parameter.Bei der Festlegung auf true gibt diese Aufgabe /Q an die Befehlszeile cmd.exe so weiter, dass die Befehlszeile nicht zu „stdout“ kopiert wird. |
| EnvironmentVariables | Optionaler String-Arrayparameter.Array aus Umgebungsvariablendefinitionen, getrennt durch Semikolons. Jede Definition sollte einen Namen und einen Wert für eine Umgebungsvariable angeben, getrennt durch ein Gleichheitszeichen. Diese Variablen werden an die erstellte ausführbare Datei zusätzlich zum regulären Umgebungsblock oder zum ausgewählten Überschreiben hinzugefügt. Beispiel: Variable1=Value1;Variable2=Value2. |
| ExitCode | Optionaler schreibgeschützter Int32-Ausgabeparameter.Gibt den durch den ausgeführten Befehl bereitgestellten Exitcode an. Wenn bei der Aufgabe Fehler protokolliert wurden, der Prozess jedoch über einen Exitcode von „0“ (Erfolg) verfügt hat, wird dies auf „-1“ festgelegt. |
| LogStandardErrorAsError | Optionaler bool-Parameter.Wenn true gegeben ist, werden alle im Standardfehlerstream empfangenen Meldungen als Fehler protokolliert. |
| StandardErrorImportance | Optionaler String-Parameter.Wichtigkeit, mit der Text aus dem Standardfehlerstream protokolliert wird. |
| StandardOutputImportance | Optionaler String-Parameter.Wichtigkeit, mit der Text aus dem Standardausgabestream protokolliert wird. |
| Timeout | Optionaler Int32-Parameter.Gibt die Zeitdauer in Millisekunden an, nach der die ausführbare Datei der Aufgabe beendet wird. Der Standardwert ist Int.MaxValue. Dieser gibt an, dass es kein Zeitlimit gibt. Das Timeout in Millisekunden. |
| ToolExe | Optionaler string-Parameter.Projekte implementieren dies möglicherweise zum Überschreiben eines ToolName. Aufgaben überschreiben dies möglicherweise zum Beibehalten des ToolName. |
| ToolPath | Optionaler string-Parameter.Gibt den Speicherort an, von wo aus die Aufgabe die zugrunde liegende ausführbare Datei lädt. Wenn dieser Parameter nicht angegeben ist, verwendet die Aufgabe den SDK-Installationspfad der Version des Frameworks, die von MSBuild ausgeführt wird. |
| UseCommandProcessor | Optionaler bool-Parameter.Wenn die Festlegung auf true gegeben ist, erstellt diese Aufgabe eine Batchdatei für die Befehlszeile und führt sie aus, indem der Befehl nicht direkt ausgeführt wird, sondern der Befehlsprozessor verwendet wird. |
| YieldDuringToolExecution | Optionaler bool-Parameter.Bei der Festlegung auf true ergibt diese Aufgabe den Knoten, wenn dessen Aufgabe ausgeführt wird. |