Vbc (Tarea)
Actualización: noviembre 2007
Contiene vbc.exe, que genera archivos ejecutables (.exe), bibliotecas de vínculos dinámicos (.dll) o módulos de código (.netmodule). Para obtener más información sobre vbc.exe, consulte Compilador de Visual Basic.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea Vbc.
Parámetro |
Descripción |
|---|---|
AdditionalLibPaths |
Parámetro String[] opcional. Especifica carpetas adicionales en las que se han de buscar los ensamblados especificados en el atributo References. |
AddModules |
Parámetro String[] opcional. Hace que el compilador facilite la información de tipos presente en los archivos especificados al proyecto que se compila actualmente. Este parámetro corresponde al modificador /addmodule del compilador de vbc.exe. |
BaseAddress |
Parámetro String opcional. Especifica la dirección base del archivo DLL. Este parámetro corresponde al modificador /baseaddress del compilador de vbc.exe. |
CodePage |
Parámetro Int32 opcional. Especifica la página de códigos que debe utilizarse para todos los archivos de código fuente en la compilación. Este parámetro corresponde al modificador /codepage del compilador de vbc.exe. |
DebugType |
Parámetro String[] opcional. Hace que el compilador genere información de depuración. Este parámetro puede tener los valores siguientes:
El valor predeterminado es full, que permite adjuntar un depurador al programa en ejecución. Un valor de pdbonly permite depurar el código fuente cuando el programa se inicializa en el depurador, pero sólo mostrará el código de lenguaje de ensamblado cuando el programa que se ejecuta está asociado al depurador. Para obtener más información, vea /debug (Visual Basic). |
DefineConstants |
Parámetro String[] opcional. Permite definir constantes condicionales para el compilador. Los pares símbolo/valor van separados por punto y coma y se especifican con la siguiente sintaxis: symbol1=value1;symbol2=value2 Este parámetro corresponde al modificador /define del compilador de vbc.exe. |
DelaySign |
Parámetro Boolean opcional. Si es true, la tarea coloca la clave pública en el ensamblado. Si es false, la tarea firma totalmente el ensamblado. El valor predeterminado es false. Este parámetro no tiene ningún efecto a menos que se utilice con el parámetro KeyFile o el parámetro KeyContainer. Este parámetro corresponde al modificador /delaysign del compilador de vbc.exe. |
DisabledWarnings |
Parámetro String opcional. Suprime las advertencias especificadas. Sólo hay que especificar la parte numérica del identificador de advertencia. Las advertencias múltiples están separadas con punto y coma. Este parámetro corresponde al modificador /nowarn del compilador de vbc.exe. |
DocumentationFile |
Parámetro String opcional. Procesa los comentarios de documentación en el archivo XML especificado. Este parámetro reemplaza el atributo GenerateDocumentation. Para obtener más información, vea /doc. |
EmitDebugInformation |
Parámetro Boolean opcional. Si es true, la tarea genera información de depuración y la coloca en un archivo .pdb. Para obtener más información, vea /debug (Visual Basic). |
ErrorReport |
Parámetro String opcional. Especifica cómo la tarea debería documentar los errores internos del compilador. Este parámetro puede tener los valores siguientes:
Si se especifica prompt y se produce un error interno del compilador, se mostrará un mensaje al usuario con la opción de enviar los datos de error a Microsoft. Si se especifica send y se produce un error interno del compilador, la tarea envía los datos de error a Microsoft. El valor predeterminado es none, que sólo muestra los errores en formato texto. Este parámetro corresponde al modificador /errorreport del compilador de vbc.exe. |
FileAlignment |
Parámetro Int32 opcional. Especifica, en bytes, dónde alinear las secciones del archivo de resultados. Este parámetro puede tener los valores siguientes:
Este parámetro corresponde al modificador /filealign del compilador de vbc.exe. |
GenerateDocumentation |
Parámetro Boolean opcional. Si es true, genera información de documentación y la coloca en un archivo XML con el nombre del archivo ejecutable o biblioteca que está creando la tarea. Para obtener más información, vea /doc. |
Imports |
Parámetro ITaskItem[] opcional. Importa los espacios de nombres de las colecciones de elementos especificadas. Este parámetro corresponde al modificador /imports del compilador de vbc.exe. |
KeyContainer |
Parámetro String opcional. Especifica el nombre del contenedor de claves criptográficas. Este parámetro corresponde al modificador /keycontainer del compilador de vbc.exe. |
KeyFile |
Parámetro String opcional. Especifica el nombre de archivo que contiene la clave criptográfica. Para obtener más información, vea /keyfile. |
LinkResources |
Parámetro ITaskItem[] opcional. Crea un vínculo con un archivo de recursos de .NET Framework en el archivo de resultados, pero el archivo de recursos no se coloca en el archivo de resultados. Este parámetro corresponde al modificador /linkresource del compilador de vbc.exe. Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al argumento identifier del modificador /linkresource, y Access corresponde al argumento filename. |
MainEntryPoint |
Parámetro String opcional. Especifica la clase o el módulo que contiene el procedimiento Sub Main. Este parámetro corresponde al modificador /main del compilador de vbc.exe. |
NoConfig |
Parámetro Boolean opcional. Especifica que el compilador no debería utilizar el archivo vbc.rsp. Este parámetro corresponde al modificador /noconfig del compilador de vbc.exe. |
NoLogo |
Parámetro Boolean opcional. Si es true, suprime la presentación de información de titular del compilador. Este parámetro corresponde al modificador /nologo del compilador de vbc.exe. |
NoStandardLib |
Parámetro Boolean opcional. Hace que el compilador no haga referencia a las bibliotecas estándar. Este parámetro corresponde al modificador /nostdlib del compilador de vbc.exe. |
NoWarnings |
Parámetro Boolean opcional. Si es true, la tarea suprime todas las advertencias. Para obtener más información, vea /nowarn. |
Optimize |
Parámetro Boolean opcional. Si es true, habilita las optimizaciones del compilador. Este parámetro corresponde al modificador /optimize del compilador de vbc.exe. |
OptionCompare |
Parámetro String opcional. Especifica la forma de realizar las comparaciones de cadenas. Este parámetro puede tener los valores siguientes:
El valor binary especifica que la tarea utiliza las comparaciones de cadenas binarias. El valor text especifica que la tarea utiliza las comparaciones de cadenas de texto. El valor predeterminado de este parámetro es binary. Este parámetro corresponde al modificador /optioncompare del compilador de vbc.exe. |
OptionExplicit |
Parámetro Boolean opcional. Si es true, se necesita la declaración explícita de variables. Este parámetro corresponde al modificador /optionexplicit del compilador de vbc.exe. |
OptionStrict |
Parámetro Boolean opcional. Si es true, la tarea fuerza la semántica de tipos estricta para que restrinja las conversiones de tipos implícitas. Este parámetro corresponde al modificador /optionstrict del compilador de vbc.exe. |
OutputAssembly |
Parámetro de salida String opcional. Especifica el nombre del archivo de resultados. Este parámetro corresponde al modificador /out del compilador de vbc.exe. |
Platform |
Parámetro String opcional. Especifica la plataforma del procesador de destino del archivo de resultados. Este parámetro puede tener un valor de x86, x64, Itanium o anycpu. El valor predeterminado es anycpu. Este parámetro corresponde al modificador /platform del compilador de vbc.exe. |
References |
Parámetro ITaskItem[] opcional. Hace que la tarea importe la información de tipo pública de los elementos especificados al proyecto actual. Este parámetro corresponde al modificador /reference del compilador de vbc.exe. |
RemoveIntegerChecks |
Parámetro Boolean opcional. Si es true, deshabilita las comprobaciones de errores del desbordamiento de enteros. El valor predeterminado es false. Este parámetro corresponde al modificador /removeintchecks del compilador de vbc.exe. |
Resources |
Parámetro ITaskItem[] opcional. Incrusta un recurso de .NET Framework en el archivo de salida. Este parámetro corresponde al modificador /resource del compilador de vbc.exe. Los elementos que se pasan a este parámetro pueden tener entradas opcionales de metadatos denominadas LogicalName y Access. LogicalName corresponde al parámetro identifier del modificador /resource, y Access corresponde al parámetro filename. |
ResponseFiles |
Parámetro ITaskItem[] opcional. Especifica el archivo de respuesta que contiene los comandos para esta tarea. Este parámetro corresponde a la opción @ (especificar archivo de respuesta) del compilador de vbc.exe. |
RootNamespace |
Parámetro String opcional. Especifica el espacio de nombres raíz para todas las declaraciones de tipos. Este parámetro corresponde al modificador /rootnamespace del compilador de vbc.exe. |
SdkPath |
Parámetro String opcional. Especifica la ubicación de mscorlib.dll y microsoft.visualbasic.dll. Este parámetro corresponde al modificador /sdkpath del compilador de vbc.exe. |
Sources |
Parámetro ITaskItem[] opcional. Especifica uno o varios archivos de origen de Visual Basic. |
TargetCompactFramework |
Parámetro Boolean opcional. Si es true, la tarea tiene como destino .NET Compact Framework. Este modificador corresponde al modificador /netcf del compilador de vbc.exe. |
TargetType |
Parámetro String opcional. Especifica el formato del archivo de resultados. Este parámetro puede tener un valor de library, que crea una biblioteca de códigos, exe, que crea una aplicación de consola, module, que crea un módulo, o winexe, que crea un programa de Windows. El valor predeterminado es library. Este parámetro corresponde al modificador /target del compilador de vbc.exe. |
Timeout |
Parámetro Int32 opcional. Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera. |
ToolPath |
Parámetro String opcional. Especifica la ubicación desde donde la tarea cargará el archivo ejecutable subyacente (vbc.exe). Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación de SDK correspondiente a la versión de Framework que está ejecutando MSBuild. |
TreatWarningsAsErrors |
Parámetro Boolean opcional. Si es true, todas las advertencias se tratan como errores. Para obtener más información, vea /warnaserror (Visual Basic). |
UseHostCompilerIfAvailable |
Parámetro Boolean opcional. Indica a la tarea que utilice el objeto de compilador en proceso, si está disponible. Utilizado únicamente por Visual Studio. |
Utf8Output |
Parámetro Boolean opcional. Registra los resultados del compilador mediante la codificación UTF-8. Este parámetro corresponde al modificador /utf8output del compilador de vbc.exe. |
Verbosity |
Parámetro String opcional. Especifica el contenido de los resultados del compilador. Los valores del contenido pueden ser Quiet, Normal (valor predeterminado), o Verbose. |
WarningsAsErrors |
Parámetro String opcional. Especifica una lista de advertencias que se tratarán como errores. Para obtener más información, vea /warnaserror (Visual Basic). Este parámetro reemplaza el parámetro TreatWarningsAsErrors. |
WarningsNotAsErrors |
Parámetro String opcional. Especifica una lista de advertencias que no se tratarán como errores. Para obtener más información, vea /warnaserror (Visual Basic). Este parámetro sólo resulta útil si el parámetro TreatWarningsAsErrors se establece en true. |
Win32Icon |
Parámetro String opcional. Inserta un archivo .ico en el ensamblado, que da el aspecto deseado al archivo de resultados en el Explorador de Windows. Este parámetro corresponde al modificador /win32icon del compilador de vbc.exe. |
Win32Resources |
Parámetro String opcional. Inserta un recurso de Win32 archivo (.res) en el archivo de resultados. Este parámetro corresponde al modificador /win32resource del compilador de vbc.exe. |
Ejemplo
En el siguiente ejemplo se compila un proyecto de Visual Basic.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>