Attività Vbc
Aggiornamento: novembre 2007
Esegue il wrapping di vbc.exe, un compilatore che genera file eseguibili con estensione exe, librerie a collegamento dinamico con estensione dll o moduli di codice con estensione netmodule. Per ulteriori informazioni su vbc.exe, vedere Compilatore di Visual Basic.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività Vbc.
Parametro |
Descrizione |
|---|---|
AdditionalLibPaths |
Parametro String[] facoltativo. Specifica cartelle aggiuntive in cui eseguire la ricerca degli assembly specificati nell'attributo References. |
AddModules |
Parametro String[] facoltativo. Permette al compilatore di rendere disponibili al progetto in corso di compilazione tutte le informazioni sui tipi presenti nei file specificati. Questo parametro corrisponde all'opzione /addmodule del compilatore vbc.exe. |
BaseAddress |
Parametro String facoltativo. Specifica l'indirizzo di base della DLL. Questo parametro corrisponde all'opzione /baseaddress del compilatore vbc.exe. |
CodePage |
Parametro Int32 facoltativo. Specifica la tabella codici da utilizzare per tutti i file di codice sorgente inclusi nella compilazione. Questo parametro corrisponde all'opzione /codepage del compilatore vbc.exe. |
DebugType |
Parametro String[] facoltativo. Determina la generazione di informazioni di debug da parte del compilatore. Per il parametro è possibile specificare i seguenti valori:
Il valore predefinito è full, che consente di associare un debugger al programma in esecuzione. Il valore pdbonly consente il debug del codice sorgente quando il programma viene avviato nel debugger, ma il codice del linguaggio assembly viene visualizzato solo quando il programma in esecuzione è associato al debugger. Per ulteriori informazioni, vedere /debug (Visual Basic). |
DefineConstants |
Parametro String[] facoltativo. Definisce le costanti di compilazione condizionale. Le coppie simbolo/valore sono separate da punti e virgola e vengono specificate utilizzando la seguente sintassi: simbolo1=valore1;simbolo2=valore2 Questo parametro corrisponde all'opzione /define del compilatore vbc.exe. |
DelaySign |
Parametro Boolean facoltativo. Se il parametro è impostato su true, la chiave pubblica viene inserita nell'assembly. Se è impostato su false, l'assembly viene firmato completamente. Il valore predefinito è false. Il parametro non ha effetto se non viene utilizzato con il parametro KeyFile o KeyContainer. Questo parametro corrisponde all'opzione /delaysign del compilatore vbc.exe. |
DisabledWarnings |
Parametro String facoltativo. Evita la visualizzazione degli avvisi specificati. È sufficiente specificare la parte numerica dell'identificatore dell'avviso. Se sono specificati più avvisi, questi sono separati da punti e virgola. Questo parametro corrisponde all'opzione /nowarn del compilatore vbc.exe. |
DocumentationFile |
Parametro String facoltativo. Elabora i commenti relativi alla documentazione nel file XML specificato. Questo parametro esegue l'override dell'attributo GenerateDocumentation. Per ulteriori informazioni, vedere /doc. |
EmitDebugInformation |
Parametro Boolean facoltativo. Se il parametro è impostato su true, le informazioni di debug vengono generate e inserite in un file pdb. Per ulteriori informazioni, vedere /debug (Visual Basic). |
ErrorReport |
Parametro String facoltativo. Specifica la modalità di segnalazione degli errori interni del compilatore. Per il parametro è possibile specificare i seguenti valori:
Se è specificato il valore prompt e si verifica un errore interno del compilatore, viene chiesto se si desidera inviare i dati dell'errore a Microsoft. Se è specificato il valore send e si verifica un errore interno del compilatore, i dati dell'errore vengono inviati a Microsoft. Il valore predefinito è none, con cui gli errori vengono segnalati solo nell'output di testo. Questo parametro corrisponde all'opzione /errorreport del compilatore vbc.exe. |
FileAlignment |
Parametro Int32 facoltativo. Specifica, in byte, il punto in cui allineare le sezioni del file di output. Per il parametro è possibile specificare i seguenti valori:
Questo parametro corrisponde all'opzione /filealign del compilatore vbc.exe. |
GenerateDocumentation |
Parametro Boolean facoltativo. Se il parametro è impostato su true, le informazioni relative alla documentazione vengono generate e inserite in un file XML con il nome dell'eseguibile o della libreria in corso di creazione. Per ulteriori informazioni, vedere /doc. |
Imports |
Parametro ITaskItem[] facoltativo. Importa gli spazi dei nomi dagli insiemi di elementi specificati. Questo parametro corrisponde all'opzione /imports del compilatore vbc.exe. |
KeyContainer |
Parametro String facoltativo. Specifica il nome del contenitore delle chiavi crittografiche. Questo parametro corrisponde all'opzione /keycontainer del compilatore vbc.exe. |
KeyFile |
Parametro String facoltativo. Specifica il nome del file contenente la chiave di crittografia. Per ulteriori informazioni, vedere /keyfile. |
LinkResources |
Parametro ITaskItem[] facoltativo. Crea un collegamento a una risorsa .NET Framework nel file di output, ma il file di risorse non viene inserito nel file di output. Questo parametro corrisponde all'opzione /linkresource del compilatore vbc.exe. Agli elementi passati a questo parametro è possibile associare metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde all'argomento identifier dell'opzione /linkresource, mentre Access corrisponde all'argomento filename. |
MainEntryPoint |
Parametro String facoltativo. Specifica la classe o il modulo che contiene la routine Sub Main. Questo parametro corrisponde all'opzione /main del compilatore vbc.exe. |
NoConfig |
Parametro Boolean facoltativo. Specifica che il file vbc.rsp non deve essere utilizzato dal compilatore. Questo parametro corrisponde al parametro /noconfig del compilatore vbc.exe. |
NoLogo |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene disattivata la visualizzazione dei messaggi informativi del compilatore. Questo parametro corrisponde all'opzione /nologo del compilatore vbc.exe. |
NoStandardLib |
Parametro Boolean facoltativo. Con questo parametro il compilatore non fa riferimento alle librerie standard. Questo parametro corrisponde all'opzione /nostdlib del compilatore vbc.exe. |
NoWarnings |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene disattivata la visualizzazione di tutti gli avvisi. Per ulteriori informazioni, vedere /nowarn. |
Optimize |
Parametro Boolean facoltativo. Se il parametro è impostato su true, vengono attivate le ottimizzazioni del compilatore. Questo parametro corrisponde all'opzione /optimize del compilatore vbc.exe. |
OptionCompare |
Parametro String facoltativo. Specifica le modalità con cui vengono confrontate le stringhe. Per il parametro è possibile specificare i seguenti valori:
Il valore binary indica l'utilizzo di confronti di stringhe binarie, mentre il valore text indica l'utilizzo di confronti di stringhe di testo. Il valore predefinito del parametro è binary. Questo parametro corrisponde all'opzione /optioncompare del compilatore vbc.exe. |
OptionExplicit |
Parametro Boolean facoltativo. Se il parametro è impostato su true, è necessario dichiarare le variabili in modo esplicito. Questo parametro corrisponde all'opzione /optionexplicit del compilatore vbc.exe. |
OptionStrict |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene attivata la semantica dei tipi rigida per limitare le conversioni implicite di tipi. Questo parametro corrisponde all'opzione /optionstrict del compilatore vbc.exe. |
OutputAssembly |
Parametro di output String facoltativo. Specifica il nome del file di output. Questo parametro corrisponde all'opzione /out del compilatore vbc.exe. |
Platform |
Parametro String facoltativo. Specifica la piattaforma processore di destinazione del file di output. Il parametro può essere impostato su x86, x64, Itanium o anycpu. Il valore predefinito è anycpu. Questo parametro corrisponde all'opzione /platform del compilatore vbc.exe. |
References |
Parametro ITaskItem[] facoltativo. Determina l'importazione delle informazioni sui tipi pubblici dagli elementi specificati nel progetto corrente. Questo parametro corrisponde all'opzione /reference del compilatore vbc.exe. |
RemoveIntegerChecks |
Parametro Boolean facoltativo. Se il parametro è impostato su true, i controlli degli errori di overflow di valori integer vengono disattivati. Il valore predefinito è false. Questo parametro corrisponde all'opzione /removeintchecks del compilatore vbc.exe. |
Resources |
Parametro ITaskItem[] facoltativo. Incorpora una risorsa .NET Framework nel file di output. Questo parametro corrisponde all'opzione /resource del compilatore vbc.exe. Agli elementi passati a questo parametro è possibile associare metadati facoltativi denominati LogicalName e Access. LogicalName corrisponde al parametro identifier dell'opzione /resource, mentre Access corrisponde al parametro filename. |
ResponseFiles |
Parametro ITaskItem[] facoltativo. Specifica il file di risposta che contiene i comandi per questa attività. Questo parametro corrisponde all'opzione @ (specifica del file di risposta) del compilatore vbc.exe. |
RootNamespace |
Parametro String facoltativo. Specifica lo spazio dei nomi di primo livello per tutte le dichiarazioni di tipi. Questo parametro corrisponde all'opzione /rootnamespace del compilatore vbc.exe. |
SdkPath |
Parametro String facoltativo. Specifica il percorso dei file mscorlib.dll e microsoft.visualbasic.dll. Questo parametro corrisponde all'opzione /sdkpath del compilatore vbc.exe. |
Sources |
Parametro ITaskItem[] facoltativo. Specifica uno o più file di origine Visual Basic. |
TargetCompactFramework |
Parametro Boolean facoltativo. Se il parametro è impostato su true, viene utilizzato .NET Compact Framework. Questa opzione corrisponde all'opzione /netcf del compilatore vbc.exe. |
TargetType |
Parametro String facoltativo. Specifica il formato del file di output. Il parametro può essere impostato su library per la creazione di una libreria di codice, su exe per la creazione di un'applicazione console, su module per la creazione di un modulo oppure su winexe per la creazione di un'applicazione Windows. Il valore predefinito è library. Questo parametro corrisponde all'opzione /target del compilatore vbc.exe. |
Timeout |
Parametro Int32 facoltativo. Specifica l'intervallo di tempo, in millisecondi, al termine del quale l'eseguibile dell'attività verrà interrotto. Il valore predefinito è Int.MaxValue, con cui viene indicato che non è stato specificato alcun periodo di timeout. |
ToolPath |
Parametro String facoltativo. Specifica il percorso da cui l'attività carica il file eseguibile sottostante (vbc.exe). Se questo parametro non è specificato, viene utilizzato il percorso di installazione SDK corrispondente alla versione del framework che esegue MSBuild. |
TreatWarningsAsErrors |
Parametro Boolean facoltativo. Se il parametro è impostato su true, tutti gli avvisi vengono considerati come errori. Per ulteriori informazioni, vedere /warnaserror (Visual Basic). |
UseHostCompilerIfAvailable |
Parametro Boolean facoltativo. Indica all'attività di utilizzare, se disponibile, l'oggetto compilatore in-process. Utilizzato solo da Visual Studio. |
Utf8Output |
Parametro Boolean facoltativo. Registra l'output del compilatore utilizzando la codifica UTF-8. Questo parametro corrisponde all'opzione /utf8output del compilatore vbc.exe. |
Verbosity |
Parametro String facoltativo. Specifica il livello di dettaglio dell'output del compilatore. Il parametro può essere impostato su Quiet, Normal (valore predefinito) o Verbose. |
WarningsAsErrors |
Parametro String facoltativo. Specifica un elenco di avvisi da considerare come errori. Per ulteriori informazioni, vedere /warnaserror (Visual Basic). Questo parametro esegue l'override del parametro TreatWarningsAsErrors. |
WarningsNotAsErrors |
Parametro String facoltativo. Specifica un elenco di avvisi da non considerare come errori. Per ulteriori informazioni, vedere /warnaserror (Visual Basic). Questo parametro risulta utile solo se il parametro TreatWarningsAsErrors è impostato su true. |
Win32Icon |
Parametro String facoltativo. Inserisce nell'assembly un file ico, che conferisce al file di output l'aspetto desiderato in Esplora risorse. Questo parametro corrisponde all'opzione /win32icon del compilatore vbc.exe. |
Win32Resources |
Parametro String facoltativo. Inserisce un file di risorse Win32 (res) nel file di output. Questo parametro corrisponde all'opzione /win32resource del compilatore vbc.exe. |
Esempio
Nell'esempio riportato di seguito viene compilato un progetto Visual Basic.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>