Vbc (attività)

Esegue il wrapping di vbc.exe, che genera file eseguibili (EXE), librerie a collegamento dinamico (DLL) o moduli di codice (NETMODULE). Per altre informazioni su vbc.exe, vedere Compilatore della riga di comando di Visual Basic.

Parametri

Nella tabella che segue vengono 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. Fa sì che il compilatore renda disponibili per il progetto in 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 usare per tutti i file del codice sorgente nella compilazione. Questo parametro corrisponde all'opzione -codepage del compilatore vbc.exe.
DebugType	Parametro String[] facoltativo. Causa la generazione di informazioni di debug da parte del compilatore. Per il parametro è possibile specificare i valori seguenti: - full - pdbonly Il valore predefinito è full, che consente di collegare un debugger al programma in esecuzione. Il valore pdbonly consente il debug del codice sorgente quando il programma viene avviato nel debugger, ma consente la visualizzazione di codice in linguaggio assembly solo se il programma in esecuzione è collegato al debugger. Per altre informazioni, vedere -debug (Visual Basic).
DefineConstants	Parametro String[] facoltativo. Definisce le costanti del compilatore condizionali. Le coppie simbolo/valore sono separate da punti e virgola e vengono specificate tramite la sintassi seguente: simbolo1=valore1;simbolo2=valore2 Questo parametro corrisponde all'opzione -define del compilatore vbc.exe.
DelaySign	Parametro Boolean facoltativo. Se true, l'attività inserisce la chiave pubblica nell'assembly. Se false, l'attività firma l'assembly completamente. Il valore predefinito è false. Questo parametro ha effetto solo se usato con il parametro KeyFile o KeyContainer. Questo parametro corrisponde all'opzione -delaysign del compilatore vbc.exe.
Deterministic	Parametro Boolean facoltativo. Se true, l'output del compilatore è un assembly il cui contenuto binario è identico in tutte le compilazioni se gli input sono identici. Per altre informazioni, vedere -deterministic.
DisabledWarnings	Parametro String facoltativo. Non visualizza gli avvisi specificati. È sufficiente specificare la parte numerica dell'identificatore dell'avviso. Se si specificano più avvisi, usare il punto e virgola per separarli. 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 altre informazioni, vedere -doc.
EmitDebugInformation	Parametro Boolean facoltativo. Se true, l'attività genera informazioni di debug e le inserisce in un file con estensione pdb. Per altre informazioni, vedere -debug (Visual Basic).
ErrorReport	Parametro String facoltativo. Specifica la modalità di segnalazione degli errori interni da parte dell'attività. Per il parametro è possibile specificare i valori seguenti: - prompt - send - none Se è specificato il valore prompt e si verifica un errore interno del compilatore, viene chiesto se si vogliono 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, in base al quale gli errori vengono segnalati solo sotto forma di 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 valori seguenti: - 512 - 1024 - 2048 - 4096 - 8192 Questo parametro corrisponde all'opzione -filealign del compilatore vbc.exe.
GenerateDocumentation	Parametro Boolean facoltativo. Se true, vengono generate informazioni di documentazione, che vengono inserite in un file XML con il nome del file eseguibile o della libreria che l'attività sta creando. Per altre informazioni, vedere -doc.
Imports	Parametro ITaskItem[] facoltativo. Importa gli spazi dei nomi dalle raccolte di elementi specificati. Questo parametro corrisponde all'opzione -imports del compilatore vbc.exe.
KeyContainer	Parametro String facoltativo. Specifica il nome del contenitore di 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 altre informazioni, vedere -keyfile.
LangVersion	Parametro System.String facoltativo. Specifica la versione del linguaggio, ad esempio "15.5".
LinkResources	Parametro ITaskItem[] facoltativo. Crea un collegamento a una risorsa .NET Framework nel file di output. Il file di risorse non viene inserito nel file di output. Questo parametro corrisponde all'opzione -linkresource del compilatore vbc.exe.
MainEntryPoint	Parametro String facoltativo. Specifica la classe o il modulo che contiene la procedura Sub Main. Questo parametro corrisponde all'opzione -main del compilatore vbc.exe.
ModuleAssemblyName	Parametro String facoltativo. Specifica l'assembly di cui il modulo fa parte.
NoConfig	Parametro Boolean facoltativo. Specifica che il compilatore non deve usare il file vbc.rsp. Questo parametro corrisponde al parametro -noconfig del compilatore vbc.exe.
NoLogo	Parametro Boolean facoltativo. Se true, elimina la visualizzazione dei messaggi informativi del compilatore. Questo parametro corrisponde all'opzione -nologo del compilatore vbc.exe.
NoStandardLib	Parametro Boolean facoltativo. Indica al compilatore di non fare riferimento alle librerie standard. Questo parametro corrisponde all'opzione -nostdlib del compilatore vbc.exe.
NoVBRuntimeReference	Parametro Boolean facoltativo. Solo per uso interno. Se true, viene impedito il riferimento automatico a Microsoft.VisualBasic.dll.
NoWarnings	Parametro Boolean facoltativo. Se true, l'attività sopprime tutti gli avvisi. Per altre informazioni, vedere -nowarn.
Optimize	Parametro Boolean facoltativo. Se true, le ottimizzazioni del compilatore vengono abilitate. Questo parametro corrisponde all'opzione -optimize del compilatore vbc.exe.
OptionCompare	Parametro String facoltativo. Specifica la modalità con cui vengono confrontate le stringhe. Per il parametro è possibile specificare i valori seguenti: - binary - text Il valore binary specifica l'uso di confronti tra stringhe binarie da parte dell'attività. Il valore text specifica l'uso di confronti tra stringhe di testo da parte dell'attività. Il valore predefinito di questo parametro è binary. Questo parametro corrisponde all'opzione -optioncompare del compilatore vbc.exe.
OptionExplicit	Parametro Boolean facoltativo. Se true, la dichiarazione esplicita delle variabili è obbligatoria. Questo parametro corrisponde all'opzione -optionexplicit del compilatore vbc.exe.
OptionInfer	Parametro Boolean facoltativo. Se true, è consentita l'inferenza del tipo delle variabili.
OptionStrict	Parametro Boolean facoltativo. Se true, l'attività applica la semantica dei tipi strict per limitare le conversioni implicite di tipi. Questo parametro corrisponde all'opzione -optionstrict del compilatore vbc.exe.
OptionStrictType	Parametro String facoltativo. Specifica quale semantica dei tipi strict genera un avviso. Al momento è supportato solo "custom". 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 del processore da impostare come destinazione del file di output. Il valore di questo parametro può essere x86, x64, Itanium o anycpu. Il valore predefinito è anycpu. Questo parametro corrisponde all'opzione -platform del compilatore vbc.exe.
References	Parametro ITaskItem[] facoltativo. Specifica l'attività per importare informazioni di tipi pubblico dagli elementi specificati nel progetto corrente. Questo parametro corrisponde all'opzione -reference del compilatore vbc.exe.
RemoveIntegerChecks	Parametro Boolean facoltativo. Se true, disabilita i controlli degli errori di overflow degli integer. Il valore predefinito è false. Questo parametro corrisponde all'opzione -removeintchecks del compilatore vbc.exe.
Resources	Parametro ITaskItem[] facoltativo. Incorpora una risorsa di .NET Framework nel file di output. Questo parametro corrisponde all'opzione -resource del compilatore vbc.exe.
ResponseFiles	Parametro ITaskItem[] facoltativo. Specifica il file di risposta che contiene i comandi per questa attività. Questo parametro corrisponde all'opzione @ (specificare il file di risposta) del compilatore vbc.exe.
RootNamespace	Parametro String facoltativo. Specifica lo spazio dei nomi radice per tutte le dichiarazioni di tipo. 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 di Visual Basic.
TargetCompactFramework	Parametro Boolean facoltativo. Se true, l'attività è destinata a .NET Compact Framework. Questa opzione corrisponde all'opzione -netcf del compilatore vbc.exe.
TargetType	Parametro String facoltativo. Specifica il formato del file di output. Questo parametro può avere un valore di library, che crea una libreria di codice, exe, che crea un'applicazione console, module, che crea un modulo o winexe, che crea un programma Windows. Il valore predefinito è library. Questo parametro corrisponde all'opzione -target del compilatore vbc.exe.
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 (vbc.exe). Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild.
TreatWarningsAsErrors	Parametro Boolean facoltativo. Se true, tutti gli avvisi vengono considerati errori. Per altre informazioni, vedere -warnaserror (Visual Basic).
UseHostCompilerIfAvailable	Parametro Boolean facoltativo. Indica all'attività di usare l'oggetto del compilatore in corso, se disponibile. Usata solo da Visual Studio.
Utf8Output	Parametro Boolean facoltativo. Registra l'output del compilatore tramite 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 livello di dettaglio può essere Quiet, Normal (impostazione predefinita) o Verbose.
WarningsAsErrors	Parametro String facoltativo. Specifica un elenco di avvisi da considerare come errori. Per altre informazioni, vedere -warnaserror (Visual Basic). Questo parametro esegue l'override del parametro TreatWarningsAsErrors.
WarningsNotAsErrors	Parametro String facoltativo. Specifica un elenco di avvisi che non vengono considerati errori. Per altre informazioni, vedere -warnaserror (Visual Basic). Questo parametro è utile solo se il parametro TreatWarningsAsErrors è impostato su true.
Win32Icon	Parametro String facoltativo. Inserisce un file con estensione ico nell'assembly, che dà al file di output l'aspetto voluto in Esplora file. Questo parametro corrisponde all'opzione -win32icon del compilatore vbc.exe.
Win32Resources	Parametro String facoltativo. Inserisce nel file di output un file di risorsa Win32 (RES). Questo parametro corrisponde all'opzione -win32resource del compilatore vbc.exe.

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.

Esempio

Nell'esempio seguente viene eseguita la compilazione di un progetto Visual Basic.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Vedi anche

• Compilatore della riga di comando di Visual Basic
• Attività
• Attività MSBuild