Strumento per la generazione di serializzatori XML (Sgen.exe)
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]:filename |
Genera codice di serializzazione per tutti i tipi contenuti nell'assembly o nell'eseguibile specificato da filename. È possibile indicare un solo nome file. Se questo argomento viene ripetuto, verrà utilizzato l'ultimo nome file. |
/c[ompiler]: options |
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 utilizzata 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 dei comandi 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 utilizzata 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]:path |
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]:assemblyfiles |
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]:type |
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 dei comandi dello strumento. |
Note
Quando lo strumento per la generazione di serializzatori XML non viene utilizzato, 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, utilizzare 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 utilizzano 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 utilizzati 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.
sgen Data.dll
Il codice che deve serializzare e deserializzare i tipi in Data.dll può fare riferimento all'assembly Data.XmlSerializers.dll.
Vedere anche
Riferimenti
Strumenti di .NET Framework
Prompt dei comandi di SDK