¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Información general sobre la precompilación de proyectos de aplicación web ASP.NET

De forma predeterminada, los archivos de código de un proyecto de aplicación web se precompilan en un único ensamblado mediante Microsoft Build Engine (MSBuild). El compilador de ASP.NET compila dinámicamente en el servidor ASP.NET Web Pages (.aspx), los controles de usuario (.ascx) y las vistas Razor de MVC (.cshtml y .vbhtml). Puede precompilar opcionalmente las páginas web, los controles de usuario y las vistas Razor también.

Nota Nota

Este tema solo se aplica a los proyectos de aplicación web. Para obtener información sobre la diferencia entre los proyectos de aplicación web y los proyectos de sitio web, vea Proyectos de aplicación web frente a proyectos de sitio web en Visual Studio.) Para obtener información acerca de cómo precompilar proyectos de sitio web, vea ASP.NET Web Site Project Precompilation Overview.

Todos los archivos de código (archivos de clase independientes, subyacentes y de diseñador) del proyecto se precompilan en un ensamblado único. De forma predeterminada, este ensamblado se compila y conserva en la carpeta Bin. Debido a que este modelo de compilación crea un único ensamblado, puede especificar atributos como el nombre y la versión del ensamblado. También puede especificar la ubicación del ensamblado de salida. Para cambiar la ubicación del ensamblado de salida, en el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, haga clic en Propiedades y, a continuación, haga clic en la pestaña Compilar. En la pestaña Compilar, hay un campo denominado Ruta de acceso de los resultados en el que podrá especificar la ruta de acceso al ensamblado de salida.

Los proyectos de aplicación web se definen mediante un archivo de proyecto en lugar de mediante una carpeta de proyecto, como sucede en los proyectos de sitio web. El archivo de proyecto hace referencia a los archivos que se incluyen en el proyecto, e incluye las referencias al ensamblado y otras configuraciones de metadatos de proyecto. Los archivos que se encuentran en la carpeta de proyecto pero que no se definen en el archivo de proyecto no se compilan como parte del proyecto de aplicación web. En el archivo de proyecto (.*proj) que se genera para cada proyecto se hace referencia a la configuración del proyecto que se agrega y se cambia mediante Visual Studio o Visual Web Developer Express.

Para ejecutar y depurar páginas, debe compilar el proyecto de aplicación web completo. Sin embargo, la compilación del proyecto de aplicación web completo puede ser rápida porque Visual Studio y Visual Web Developer Express usan un modelo de compilación incremental que únicamente compila los archivos que han cambiado.

Para obtener más información, vea Web Application Projects Overview.

Aa983464.collapse_all(es-es,VS.110).gifCompilar archivos de clase

Los proyectos de aplicación web usan MSBuild para compilar los archivos de clase. Estos archivos de clase se compilan en un único ensamblado. De forma predeterminada, se colocan en la carpeta Bin. Puede extender y personalizar el proceso de compilación mediante reglas de extensibilidad estándar de MSBuild. Para obtener más información, vea MSBuild.

En la tabla siguiente se describen los tipos de archivos de clase de proyecto de aplicación web que se compilan en un ensamblado único.

Tipo de archivo de clase

Descripción

Independiente

Archivos de clase que se pueden crear y agregar a la carpeta Bin.

Subyacente

Código definido por el usuario que define la presentación y otros comportamientos de ASP.NET Web Pages.

Diseñador

Código que se genera automáticamente. No debe modificar el archivo .designer.

Aa983464.collapse_all(es-es,VS.110).gifPersonalizar opciones de compilación

Puede especificar el nombre, la versión y otros detalles del ensamblado de salida utilizando elementos de la página de propiedades Aplicación de la ventana Diseñador de proyectos. Utilice la página Compilar de la ventana Diseñador de proyectos para especificar la configuración de compilación del proyecto. Por ejemplo, puede especificar cómo se administran los errores y especificar detalles sobre el resultado del ensamblado. Además puede agregar pasos anteriores y posteriores a la generación durante la compilación estableciendo valores de la página de propiedades Eventos de compilación. Para obtener más información sobre las páginas de propiedades, vea Referencia de la interfaz de usuario del Diseñador de proyectos.

De forma predeterminada, MSBuild solo compila archivos de clase de proyectos de aplicación web cuya propiedad Acción de compilación está establecida en Compilar. Sin embargo, si un proyecto de aplicación web incluye archivos de clase en la carpeta App_Code, ASP.NET compilará estos archivos de clase. Esto es así aunque la acción de compilación no esté establecida de forma explícita en Compilar.

Nota Nota

La carpeta App_Code existe para los proyectos de sitio web. Esta carpeta no se suele incluir en los proyectos de aplicación web. Para obtener más información sobre la carpeta App_Code , vea Shared Code Folders in ASP.NET Web Sites.

Aunque los archivos de código del proyecto se precompilan en un ensamblado único usando MSBuild, el compilador de ASP.NET compila dinámicamente en el servidor las ASP.NET Web Pages (.aspx), los controles de usuario (.ascx) y las vistas Razor de MVC (.cshtml y .vbhtml) de un proyecto de aplicación web. Esto significa que puede realizar cambios limitados en las ASP.NET Web Pages, los controles de usuario y las vistas Razor del sitio después de compilarlos e implementarlos. Por ejemplo, se puede cambiar la organización de los controles, colores, fuentes y otros aspectos relacionados con el aspecto de las páginas. Cuando el sitio recibe la primera solicitud para una página después de realizar el cambio, ASP.NET vuelve a compilar los archivos cambiados.

Puede definir un control en el archivo de código subyacente siempre que lo haga público o protegido. Dado que la página .aspx hereda del archivo de código subyacente, la página usará ese control. El desplazamiento de la definición de un control al archivo de código subyacente es útil en las situaciones siguientes:

  • Cuando el tipo del control debe derivarse de un tipo ASP.NET integrado.

  • Si desea un ámbito para el control distinto del ámbito predeterminado. El ámbito hace referencia al nivel de accesibilidad, como public, private, internal, protected y protected internal.

  • Si desea agregar atributos de metadatos a la declaración del control.

  • Si desea escribir comentarios de código XML para la declaración del control.

Para obtener más información acerca de cómo agregar controles, vea How to: Add Controls to an ASP.NET Web Page Programmatically.

De forma predeterminada, todos los archivos de clase se compilan en un único ensamblado, lo que significa que solo es necesario implementar dicho ensamblado, junto con los archivos .aspx, .ascx, .cshtml y .vbhtml y los archivos de contenido estático. En este escenario, el marcado de los archivos .aspx, .ascx, .cshtml y .vbhtml no se compila en código ejecutable hasta que el explorador solicita la página.

Sin embargo, puede especificar varias opciones de compilación y de combinación. Por ejemplo, puede precompilar archivos .aspx o puede especificar que se deben crear varios ensamblados en lugar de solo uno. Para obtener más información sobre las opciones de compilación y combinación de proyectos de aplicación web y cómo especificarlas, vea los siguientes recursos:

Para obtener información sobre cómo implementar proyectos de aplicaciones web, vea Mapa de contenido de implementación web para Visual Studio y ASP.NET.

Adiciones de comunidad

Mostrar:
© 2015 Microsoft