XML Serializer Generator-Tool (Sgen.exe)

Der XML Serializer Generator erstellt eine XML-Serialisierungsassembly für die Typen in einer bestimmten Assembly, um die Startleistung von XmlSerializer beim Serialisieren oder Deserialisieren von Objekten der angegebenen Typen zu erhöhen.

sgen [options]

Parameter

Option	Beschreibung
/a[ssembly]:filename	Generiert den Serialisierungscode für alle Typen, die in der durch filename angegebenen Assembly oder ausführbaren Datei enthalten sind. Nur ein Dateiname kann bereitgestellt werden. Bei Wiederholung dieses Arguments wird der letzte Dateiname verwendet.
/c[ompiler]: options	Gibt die Optionen für die Übergabe an den C#-Compiler an. Bei Übergabe an den Compiler werden alle csc.exe-Optionen unterstützt. Damit kann angegeben werden, dass die Assembly signiert werden soll. Außerdem kann die Schlüsseldatei angegeben werden.
/d[ebug]	Generiert ein Image, das mit einem Debugger verwendet werden kann.
/f[orce]	Erzwingt das Überschreiben einer vorhandenen, gleichnamigen Assembly. Die Standardeinstellung ist false.
/help oder /?	Zeigt die Befehlssyntax und Optionen für das Tool an.
/k[eep]	Unterdrückt das Löschen der generierten Quelldateien und anderer temporärer Dateien, nachdem sie in die Serialisierungsassembly kompiliert wurden. Damit kann ermittelt werden, ob das Tool für einen bestimmten Typ Serialisierungscode generiert.
/n[ologo]	Unterdrückt die Anzeige des Startbanners von Microsoft.
/o[ut]:-	Gibt das Verzeichnis an, in das die generierte Assembly gespeichert werden soll. Hinweis: Der Name der generierten Assembly besteht aus dem Namen der Eingabeassembly plus "xmlSerializers.dll".
/p[roxytypes]	Generiert Serialisierungscode nur für die Proxytypen des XML-Webdiensts.
/r[eference]:assemblyfiles	Gibt die Assemblys an, auf die von den Typen, die XML-Serialisierung erfordern, verwiesen wird. Akzeptiert mehrere Assemblydateien, die durch Kommas getrennt werden.
/s[ilent]	Unterdrückt die Anzeige von Erfolgsmeldungen.
/t[ype]:type	Generiert Serialisierungscode nur für den angegebenen Typ.
/v[erbose]	Zeigt eine ausführliche Ausgabe für das Debuggen an. Listet Typen aus der Zielassembly auf, die nicht mit XmlSerializer serialisiert werden können.
/?	Zeigt die Befehlssyntax und Optionen für das Tool an.

Hinweise

Wenn der XML Serializer Generator nicht verwendet wird, generiert XmlSerializer bei jeder Ausführung einer Anwendung für jeden Typ Serialisierungscode und eine Serialisierungsassembly. Zur Verbesserung der Leistung beim Starten der XML-Serialisierung verwenden Sie das Tool Sgen.exe, um die Assemblys im Voraus zu generieren. Diese Assemblys können dann zusammen mit der Anwendung bereitgestellt werden.

Mit dem XML Serializer Generator kann auch die Leistung von Clients, die zur Kommunikation mit Servern XML-Webdienstproxys verwenden, verbessert werden, da die Leistung durch den Serialisierungsprozess beim erstmaligen Laden des Typs nicht beeinträchtigt wird.

Die generierten Assemblys können nicht auf der Serverseite eines Webdiensts verwendet werden. Dieses Tool wird nur für Webdienstclients und manuelle Serialisierungsszenarien verwendet.

Wenn der Name der Assembly, die den zu serialisierenden Typen enthält, MyType.dll ist, erhält die zugehörige Serialisierungsassembly den Namen MyType.XmlSerializers.dll.

Beispiele

Mit dem folgenden Befehl wird eine Assembly mit dem Namen Data.XmlSerializers.dll erstellt, um alle in der Assembly Data.dll enthaltenen Typen zu serialisieren.

sgen Data.dll 

Auf die Data.XmlSerializers.dll-Assembly kann von dem Code verwiesen werden, der die Typen in Data.dll serialisiert und deserialisiert.

Siehe auch

Weitere Ressourcen

.NET Framework Tools
XML Web Services Overview
SDK Command Prompt

Erstellungsdatum: 2010-03-10