Condividi tramite

SGen (attività)

  • Articolo

Crea un assembly di serializzazione XML per i tipi presenti nell'assembly specificato. Questa attività esegue il wrapping dello strumento per la generazione di serializzatori XML Sgen.exe. Per altre informazioni, vedere Strumento per la generazione di serializzatori XML (Sgen.exe).

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività SGen.

Parametro Descrizione
BuildAssemblyName Parametro String obbligatorio.

Assembly per cui generare il codice di serializzazione.
BuildAssemblyPath Parametro String obbligatorio.

Percorso dell'assembly per cui generare il codice di serializzazione.
DelaySign Parametro Boolean facoltativo.

Se true, specifica che si vuole solo posizionare la chiave pubblica nell'assembly. Se false, specifica che si vuole un'assembly completamente firmata.

Questo parametro ha effetto solo se usato con il parametro KeyFile o KeyContainer.
KeyContainer Parametro String facoltativo.

Specifica un contenitore che include una coppia di chiavi. Tale parametro firmerà l'assembly mediante l'inserimento di una chiave pubblica nel relativo manifesto. L'attività firmerà quindi l'assembly finale con la chiave privata.
KeyFile Parametro String facoltativo.

Specifica una coppia di chiavi o una chiave pubblica da usare per firmare un assembly. Durante la compilazione la chiave pubblica verrà inserita nel manifesto dell'assembly, mentre l'assembly finale verrà firmato con la chiave privata.
Platform Parametro String facoltativo.

Ottiene o imposta la piattaforma del compilatore usata per generare l'assembly di output. Il valore di questo parametro può essere x86, x64 o anycpu. Il valore predefinito è anycpu.
References Parametro String[] facoltativo.

Specifica gli assembly a cui fanno riferimento i tipi che richiedono la serializzazione XML.
SdkToolsPath Parametro String facoltativo.

Specifica il percorso degli strumenti SDK, ad esempio resgen.exe.
SerializationAssembly Parametro di output ITaskItem[] facoltativo.

Contiene l'assembly di serializzazione generato.
SerializationAssemblyName Parametro String facoltativo.

Specifica il nome dell'assembly di serializzazione generato.
ShouldGenerateSerializer Parametro Boolean obbligatorio.

Se true, l'attività SGen deve generare un assembly di serializzazione.
Timeout Parametro Int32 facoltativo.

Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout.
ToolPath Parametro String facoltativo.

Specifica la posizione da cui l'attività caricherà il file eseguibile sottostante (sgen.exe). Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild.
Types Parametro String[] facoltativo.

Ottiene o imposta un elenco di tipi specifici per cui generare il codice di serializzazione. L'attività SGen genererà il codice di serializzazione solo per questi tipi.
UseProxyTypes Parametro Boolean obbligatorio.

Se true, l'attività SGen genera il codice di serializzazione solo per i tipi proxy del servizio Web XML.

Parametri ToolTaskExtension

Questa attività eredita dalla ToolTaskExtension classe , che eredita dalla ToolTask classe , che a sua volta eredita dalla Task classe . Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano.

Nella tabella seguente vengono descritti i parametri delle classi di base:

Parametro Descrizione
EchoOff Parametro bool facoltativo.

Se impostata su true, questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout.
EnvironmentVariables Parametro di matrice String facoltativo.

Matrice di definizioni di variabili di ambiente, separate da punti e virgola. Ogni definizione deve specificare un nome di variabile di ambiente e un valore separati da un segno di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard. Ad esempio, Variable1=Value1;Variable2=Value2.
ExitCode Parametro di sola lettura di output Int32 facoltativo.

Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1.
LogStandardErrorAsError Parametro bool facoltativo.

Se true, tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori.
StandardErrorImportance Parametro String facoltativo.

Importanza con cui registrare il testo dal flusso di errore standard.
StandardOutputImportance Parametro String facoltativo.

Importanza con cui registrare il testo dal flusso di output standard.
Timeout Parametro Int32 facoltativo.

Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi.
ToolExe Parametro string facoltativo.

I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName.
ToolPath Parametro string facoltativo.

Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild.
UseCommandProcessor Parametro bool facoltativo.

Se true, questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando.
YieldDuringToolExecution Parametro bool facoltativo.

Se true, questa attività restituisce il nodo quando l'attività è in esecuzione.

Vedi anche