Strumento per la generazione di serializzatori XML (Sgen.exe)

Articolo
02/25/2015

Lo strumento per la generazione di serializzatori XML (Sgen.exe) consente di creare un assembly di serializzazione XML per i tipi in un assembly specificato al fine di migliorare le prestazioni di avvio di un oggetto XmlSerializer quando serializza o deserializza oggetti dei tipi specificati.

sgen [options]

Parametri

Opzione	Descrizione
/a[ssembly]:nomefile	Genera il codice di serializzazione per tutti i tipi contenuti nell'assembly o nell'eseguibile specificato dal filename. È possibile indicare un solo nome file. Se questo argomento viene ripetuto, verrà usato l'ultimo nome file.
/c[ompiler]: opzioni	Specifica l'opzione da passare al compilatore C#. Tutte le opzioni di csc.exe vengono supportate dopo essere state passate al compilatore. Questa opzione può essere usata per specificare che l'assembly deve essere firmato e per indicare il file di chiave.
/d[ebug]	Genera un'immagine utilizzabile con un debugger.
/f[orce]	Impone la sovrascrittura di un assembly esistente con lo stesso nome. Il valore predefinito è false.
/help or /?	Visualizza la sintassi e le opzioni di comando dello strumento.
/k[eep]	Impedisce l'eliminazione dei file di origine generati e di altri file temporanei al termine della compilazione nell'assembly di serializzazione. Questa opzione può essere usata per determinare se lo strumento genera codice di serializzazione per un determinato tipo.
/n[ologo]	Elimina la visualizzazione del messaggio di avvio Microsoft.
/o[ut]:percorso	Specifica la directory in cui salvare l'assembly generato. Nota Il nome dell'assembly generato è composto dal nome dell'assembly di input e da "xmlSerializers.dll".
/p[roxytypes]	Genera codice di serializzazione solo per i tipi proxy del servizio Web XML.
/r[eference]:fileassembly	Specifica gli assembly a cui fanno riferimento i tipi che richiedono la serializzazione XML. Accetta più file di assembly separati da virgole.
/s[ilent]	Evita la visualizzazione dei messaggi di operazione riuscita.
/t[ype]:tipo	Genera codice di serializzazione solo per il tipo specificato.
/v[erbose]	Visualizza output dettagliato per il debug. Elenca i tipi dell'assembly di destinazione che non possono essere serializzati con XmlSerializer.
/?	Visualizza la sintassi e le opzioni di comando dello strumento.

Note

Quando lo strumento per la generazione di serializzatori XML non viene usato, un oggetto XmlSerializer genera codice e un assembly di serializzazione per ogni tipo ogni volta che viene eseguita un'applicazione. Per migliorare le prestazioni dell'avvio della serializzazione XML, usare lo strumento Sgen.exe per generare gli assembly in anticipo. Tali assembly potranno quindi essere distribuiti insieme all'applicazione.

Lo strumento per la generazione di serializzatori XML può inoltre migliorare le prestazioni dei client che usano i proxy del servizio Web XML per comunicare con i server, in quanto il processo di serializzazione non influisce sulle prestazioni quando il tipo viene caricato per la prima volta.

Gli assembly generati non possono essere usati sul lato server di un servizio Web. Questo strumento è destinato esclusivamente ai client del servizio Web e agli scenari di serializzazione manuale.

Se l'assembly contenente il tipo da serializzare è denominato MyType.dll, l'assembly di serializzazione associato verrà denominato MyType.XmlSerializers.dll.

Esempi

Il comando seguente crea un assembly denominato Data.XmlSerializers.dll per la serializzazione di tutti i tipi contenuti nell'assembly denominato Data.dll.