Notas de la versin de ASP.

NET MVC 3 Tools Update

Informacin general...................................................................................................2 Notas de la instalacin...............................................................................................2 Requisitos de software...............................................................................................3 Documentacin..........................................................................................................3 Soporte tcnico.......................................................................................................... 3 Actualizar un proyecto de ASP.NET MVC 2 a ASP.NET MVC 3.....................................4 Cambios en ASP.NET MVC 3 Tools Update..................................................................6
El cuadro de dilogo "Agregar controlador" ahora puede aplicar la tcnica scaffolding a controladores con vistas y cdigo de acceso de datos.........................................................6 Mejoras en el cuadro de dilogo "Nuevo proyecto de ASP.NET MVC 3"...............................9 Las plantillas de proyecto ahora incluyen Modernizr 1.7...................................................11 Las plantillas de proyecto incluyen versiones actualizadas de jQuery, jQuery UI y jQuery Validation...........................................................................................................................11 Las plantillas de proyecto ahora incluyen ADO.NET Entity Framework 4.1 como un paquete NuGet preinstalado............................................................................................................11 Las plantillas de proyecto incluyen bibliotecas de JavaScript como paquetes NuGet preinstalados.....................................................................................................................12

Problemas conocidos................................................................................................12

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 1 Copyright 2011 Microsoft Corporation

Informacin general
En este documento se describe la versin de ASP.NET MVC 3 Tools Update para Visual Studio 2010. Nota: esta versin es una actualizacin de las herramientas de Visual Studio que admiten ASP.NET MVC 3 RTM. No hay ningn cambio en la funcionalidad en tiempo de ejecucin de ASP.NET MVC 3 en esta versin; el ensamblado System.Web.Mvc.dll no se ha actualizado. ASP.NET MVC es un marco de trabajo que usa el patrn de Controlador de vista de modelo (MVC) para el desarrollo de aplicaciones web. El instalador de ASP.NET MVC 3 Tools Update incluye los componentes siguientes: Componentes en tiempo de ejecucin de ASP.NET MVC 3. Herramientas de ASP.NET MVC 3 para Visual Studio 2010. Componentes en tiempo de ejecucin de ASP.NET Web Pages. Herramientas de ASP.NET Web Pages para Visual Studio 2010. Administrador de paquetes de Microsoft para .NET (NuGet) versin 1.2. Una revisin para Visual Studio 2010 que habilita la compatibilidad con la sintaxis Razor.

Las notas de todas las versiones preliminares de ASP.NET MVC 3 se encuentran en el sitio web de ASP.NET en la siguiente direccin URL: http://www.asp.net/learn/whitepapers/mvc3-release-notes

Notas de la instalacin
Nota importante: asegrese de que todas las instancias de Visual Studio estn cerradas antes de instalar ASP.NET MVC 3 Tools Update. Para instalar ASP.NET MVC 3 Tools Update mediante el Instalador de plataforma web (Web PI), visite la pgina siguiente: http://www.microsoft.com/web/gallery/install.aspx?appid=MVC3

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 2 Copyright 2011 Microsoft Corporation

O bien, puede descargar el instalador de ASP.NET MVC 3 Tools Update para Visual Studio 2010 desde la pgina siguiente: http://go.microsoft.com/fwlink/?LinkID=208140 ASP.NET MVC 3 Tools Update se puede instalar y ejecutar en paralelo con ASP.NET MVC 2 Tools para Visual Studio 2010. Si ya tiene ASP.NET MVC 3 RTM instalado, puede realizar la actualizacin ejecutando el instalador de ASP.NET MVC 3 Tools Update. No es necesario desinstalar la instalacin existente de ASP.NET MVC 3.

Requisitos de software
Los componentes en tiempo de ejecucin de ASP.NET MVC 3 necesitan el software siguiente: .NET Framework versin 4.

Las herramientas de ASP.NET MVC 3 para Visual Studio 2010 necesitan el software siguiente: Visual Studio 2010 o Visual Web Developer 2010 Express.

Documentacin
La documentacin de ASP.NET MVC est disponible en el sitio web de MSDNen la siguiente direccin URL: http://go.microsoft.com/fwlink/?LinkId=205717 Hay disponibles tutoriales y otra informacin sobre ASP.NET MVC en la pgina relativa a MVC del sitio web de ASP.NET en la siguiente direccin URL: http://www.asp.net/mvc/

Soporte tcnico
Se trata de una versin con soporte tcnico completo. En el sitio web de soporte tcnico de Microsoft hay informacin sobre cmo obtener soporte tcnico. Tambin se pueden plantear preguntas sobre esta versin en el foro de ASP.NET MVC, donde los miembros de la comunidad de ASP.NET normalmente pueden ofrecer soporte tcnico informal:

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 3 Copyright 2011 Microsoft Corporation

http://forums.asp.net/1146.aspx

Actualizar un proyecto de ASP.NET MVC 2 a ASP.NET MVC 3

Para actualizar manualmente una aplicacin existente de ASP.NET MVC 2 a la versin 3, haga lo siguiente: 1. Cree un nuevo proyecto vaco de ASP.NET MVC 3 en el equipo. Este proyecto contendr algunos archivos que son necesarios para la actualizacin. 2. Copie los siguientes archivos del proyecto de ASP.NET MVC 3 a la ubicacin correspondiente del proyecto de ASP.NET MVC 2. Necesitar actualizar todas las referencias a la biblioteca jQuery para reflejar el nuevo nombre de archivo (jQuery-1.5.1.js): /Views/Web.config /packages.config /scripts/*.js /Content/themes/*.*

3. Copie la carpeta packages de la raz de la solucin del proyecto de ASP.NET MVC 3 vaco a la raz de su solucin, que est en el directorio donde se encuentra el archivo .sln de la solucin. 4. Si su proyecto de ASP.NET MVC 2 contiene algn rea, copie el archivo /Views/Web.config a la carpeta Views de cada rea. 5. En ambos archivos Web.config del proyecto de ASP.NET MVC 2, busque y reemplace globalmente la versin de ASP.NET MVC. Busque lo siguiente:
System.Web.Mvc, Version=2.0.0.0

Reemplcelo con lo siguiente:

System.Web.Mvc, Version=3.0.0.0

6. En el Explorador de soluciones, elimine la referencia a System.Web.Mvc (que apunta al archivo DLL de la versin 2) y, a continuacin, agregue una referencia a System.Web.Mvc (v3.0.0.0). 7. Agregue una referencia a System.WebPages.dll y a System.Web.Helpers.dll. Estos ensamblados se encuentran en las carpetas siguientes:

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 4 Copyright 2011 Microsoft Corporation

%ProgramFiles%\ Microsoft ASP.NET\ASP.NET MVC 3\Assemblies %ProgramFiles%\ Microsoft ASP.NET\ASP.NET Web Pages\v1.0\Assemblies

8. En el Explorador de soluciones, haga clic con el botn secundario en el nombre del proyecto y, a continuacin, seleccione Descargar proyecto. Despus, vuelva a hacer clic con el botn secundario en el nombre del proyecto y seleccione Editar NombreDelProyecto.csproj. 9. Busque el elemento ProjectTypeGuids y reemplace {F85E285D-A4E0-4152-9332AB1D724D3325} con {E53F8FEA-EAE0-44A6-8774-FFD645390401}. 10.Guarde los cambios, haga clic con el botn secundario en el proyecto y, a continuacin, seleccione Volver a cargar el proyecto. 11.En el archivo Web.config de la raz de la aplicacin, agregue la configuracin siguiente a la seccin assemblies.
<add assembly="System.Web.WebPages, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />

<add assembly="System.Web.Helpers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" />

12.Si el proyecto hace referencia a cualquier biblioteca de terceros compilada mediante ASP.NET MVC 2, agregue el siguiente elemento bindingRedirect resaltado al archivo Web.config de la raz de la aplicacin en la seccin configuration:
<runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <dependentAssembly> <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35"/> <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="3.0.0.0"/> </dependentAssembly> </assemblyBinding> </runtime>

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 5 Copyright 2011 Microsoft Corporation

Cambios en ASP.NET MVC 3 Tools Update

En esta seccin se describen los cambios realizados en la versin ASP.NET MVC 3 Tools Update con respecto a la versin ASP.NET MVC 3 RTM.

El cuadro de dilogo "Agregar controlador" ahora puede aplicar la tcnica scaffolding a controladores con vistas y cdigo de acceso de datos
La tcnica scaffolding es una manera de generar rpidamente un controlador y vistas para una aplicacin. Una vez generado el cdigo, puede editarlo de acuerdo con los requisitos del proyecto. Para iniciar el cuadro de dilogo Agregar controlador de ASP.NET MVC 3, haga clic con el botn secundario en la carpeta Controladores del Explorador de soluciones, haga clic en Agregar y, a continuacin, haga clic en Controlador. El cuadro de dilogo se ha mejorado y ahora ofrece opciones de scaffolding adicionales.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 6 Copyright 2011 Microsoft Corporation

Hay tres plantillas para scaffold disponibles de forma predeterminada.

Vaciar controlador

Esta plantilla genera un archivo de controlador vaco. Esta plantilla es equivalente a no activar Agregar mtodos de accin para los escenarios Create, Update, Delete y Details en las versiones anteriores de ASP.NET MVC. Si la elige, no hay ms opciones disponibles.
Controlador con acciones de lectura y escritura

Esta plantilla genera un archivo de controlador que tiene todos los mtodos de accin necesarios pero ningn cdigo de implementacin en los mtodos. Esta plantilla es equivalente a activar Agregar mtodos de accin para los escenarios Create, Update, Delete y Details en las versiones anteriores de ASP.NET MVC. Si la elige, no hay ms opciones disponibles.
Controlador con acciones de lectura y escritura y vistas, que usa Entity Framework

Esta plantilla le permite crear rpidamente una interfaz de usuario para entrada de datos que funcione. Genera cdigo que administra diversos requisitos y escenarios comunes, como los siguientes: Acceso a datos. El cdigo generado lee y escribe entidades en una base de datos. Funciona con el enfoque Code First de Entity Framework si elige una clase de contexto de datos existente o si permite que la plantilla genere una nueva clase DbContext. Tambin funciona con el enfoque Database First o Model First de Entity Framework si elige una clase ObjectContext existente. Validacin. El cdigo generado usa caractersticas de enlace de modelos y metadatos de ASP.NET MVC, por lo que los envos de formularios se validan de acuerdo con las reglas declaradas en la clase de modelo. Esto incluye reglas de validacin integradas, como los atributos Required y StringLength, y reglas de validacin personalizadas. Relaciones uno a varios. Si define relaciones uno a varios de clave externa entre las clases de modelo, el cdigo generado producir listas desplegables para seleccionar entidades relacionadas. Por ejemplo, se pueden definir las clases de modelo siguientes usando las convenciones Code First de Entity Framework:
public class Product {

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 7 Copyright 2011 Microsoft Corporation

public int ProductId { get; set; } [Required] public string Name { get; set; }

// Product belongs to Category public int CategoryId { get; set; } public virtual Category Category { get; set; } }

public class Category { public int CategoryId { get; set; } [Required] public string Name { get; set; } }

Al aplicar la tcnica scaffolding a un controlador para la clase Product, sus vistas permitirn a los usuarios elegir un objeto Category para cada instancia de Product. Esta plantilla habilita opciones adicionales en el cuadro de dilogo Agregar controlador. En Clase de modelo, puede elegir cualquier clase de modelo de la solucin, lo que determina el tipo de datos que los usuarios podrn crear o editar: Si desea usar Code First de Entity Framework, puede elegir cualquier clase de modelo. Si est usando Database First o Model First de Entity Framework, asegrese de elegir una clase de entidad definida en el modelo conceptual.

En Clase de contexto de datos, puede elegir entre estas opciones:

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 8 Copyright 2011 Microsoft Corporation

Si desea usar Code First y no tiene ninguna clase de contexto de datos existente, elija <Nuevo contexto de datos>. Se generar automticamente una clase de contexto de datos. Si desea usar Code First y tiene una clase de contexto de datos existente, eljala aqu. Se actualizar para almacenar la clase de modelo que ha seleccionado. Si est usando Database First o Model First, elija aqu la clase de contexto del objeto.

En Vistas, elija el motor de vistas que desee usar o elija Ninguno si no desea aplicar la tcnica scaffolding a ninguna vista. Puede seleccionar Opciones avanzadas para especificar ms opciones para las vistas generadas. Por ejemplo, puede elegir el diseo o la pgina maestra que desea usar.

Mejoras en el cuadro de dilogo "Nuevo proyecto de ASP.NET MVC 3"

El cuadro de dilogo que se usa para crear nuevos proyectos de ASP.NET MVC 3 incluye varias mejoras, que se indican a continuacin.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 9 Copyright 2011 Microsoft Corporation

Nueva plantilla para proyectos de intranet

La lista Plantilla de proyecto incluye una nueva plantilla Aplicacin de Intranet. Esta plantilla contiene configuraciones para compilar una aplicacin web usando autenticacin de Windows en lugar de autenticacin de formularios. Puesto que una aplicacin de intranet necesita algunas configuraciones de IIS que no se pueden encapsular en una plantilla de proyecto, la plantilla incluye un archivo lame con instrucciones sobre cmo hacer que la plantilla de proyecto funcione en IIS. La documentacin de la nueva plantilla Aplicacin de Intranet est disponible en el sitio web de MSDN en la siguiente direccin URL: http://msdn.microsoft.com/en-us/library/gg703322(VS.98).aspx
Las plantillas de proyecto estn ahora habilitadas para HTML5

El cuadro de dilogo de nuevo proyecto contiene ahora una opcin para agregar caractersticas especficas de HTML5 a las plantillas de proyecto. Al seleccionar esta

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 10 Copyright 2011 Microsoft Corporation

opcin se generan vistas que contienen los nuevos elementos <header>, <footer> y <navigation> de HTML5. Tenga en cuenta que las versiones anteriores de los exploradores no admiten etiquetas especficas de HTML5. Para resolver esta limitacin, las plantillas de proyecto HTML5 incluyen una referencia a la biblioteca Modernizr. (Vea la prxima seccin.)

Las plantillas de proyecto ahora incluyen Modernizr 1.7

Modernizr es una biblioteca de JavaScript que habilita la compatibilidad con CSS 3 y HTML5 en los exploradores que todava no admiten estas caractersticas. Esta biblioteca se incluye como un paquete NuGet preinstalado en las plantillas para los proyectos de ASP.NET MVC 3. Para obtener ms informacin sobre Modernizr, vea http://www.modernizr.com/.

Las plantillas de proyecto incluyen versiones actualizadas de jQuery, jQuery UI y jQuery Validation
Las plantillas de proyecto incluyen ahora las siguientes versiones de los scripts jQuery: jQuery 1.5.1 jQuery Validation 1.8 jQuery UI 1.8.11

Estas bibliotecas se incluyen como paquetes NuGet preinstalados.

Las plantillas de proyecto ahora incluyen ADO.NET Entity Framework 4.1 como un paquete NuGet preinstalado
ADO.NET Entity Framework 4.1 incluye la caracterstica Code First. Code First es un nuevo modelo de desarrollo para ADO.NET Entity Framework que ofrece una alternativa a los modelos Database First y Model First existentes. Code First se centra en definir el modelo usando clases POCO ("tipos de objetos CLR antiguos sin formato") escritas en Visual Basic o en C#. Estas clases se pueden asignar a una base de datos existente o se pueden usar para generar un esquema de base de datos. Es posible proporcionar configuracin adicional mediante atributos DataAnnotations o usando API fluidas.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 11 Copyright 2011 Microsoft Corporation

La documentacin sobre el uso de Code First con ASP.NET MVC est disponible en el sitio web de ASP.NET en las siguientes direcciones URL: http://www.asp.net/mvc/tutorials/getting-started-with-mvc3-part1-cs http://www.asp.net/entity-framework/tutorials/creating-an-entity-framework-datamodel-for-an-asp-net-mvc-application

Las plantillas de proyecto incluyen bibliotecas de JavaScript como paquetes NuGet preinstalados
Al crear un nuevo proyecto de ASP.NET MVC 3, el proyecto incluye los archivos JavaScript mencionados previamente (por ejemplo, la biblioteca Modernizr) instalndolos mediante NuGet en lugar de agregar directamente los scripts a la carpeta Scripts en el contenido de la plantilla de proyecto. Esto le permite usar NuGet para actualizar los scripts a la versin ms reciente cuando se publiquen nuevas versiones de los scripts. Por ejemplo, dada la frecuencia de las nuevas versiones de jQuery, la versin de jQuery incluida en la plantilla de proyecto quedar obsoleta en algn momento. Sin embargo, puesto que jQuery se incluye como un paquete NuGet instalado, se le avisar en el cuadro de dilogo de NuGet cuando haya disponibles versiones ms recientes de jQuery. Como jQuery incluye el nmero de versin en el nombre de archivo, la actualizacin de jQuery a la versin ms reciente tambin hace necesario actualizar la etiqueta <script> que hace referencia al archivo jQuery para indicar el nuevo nombre de archivo. Otras bibliotecas de script incluidas no incorporan el nmero de versin en el nombre del script, por lo que se pueden actualizar ms fcilmente a sus versiones ms recientes.

Problemas conocidos
En algunos casos, se puede producir un error en la instalacin y aparecer el mensaje Error de instalacin. Cdigo de error: (0x80070643). Para obtener informacin sobre cmo evitar este problema, vea el artculo 2531566 de Knowledge Base. La tcnica de scaffolding para agregar un controlador no aplica scaffolding a entidades que aprovechan la compatibilidad con la herencia de entidades dentro de Entity Framework. Por ejemplo, dada una clase base Persona heredada por una clase Alumno, al aplicar scaffolding a la clase Alumno se generar cdigo que no se compila.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 12 Copyright 2011 Microsoft Corporation

La creacin de un nuevo proyecto de ASP.NET MVC 3 dentro de una carpeta de soluciones produce un error NullReferenceException. La solucin alternativa consiste en crear el proyecto de ASP.NET MVC 3 en la raz de la solucin y, a continuacin, moverlo a la carpeta de soluciones. IntelliSense para la sintaxis Razor no funciona cuando se instala ReSharper. Si tiene instalado ReSharper y desea aprovechar la compatibilidad con IntelliSense para Razor de ASP.NET MVC 3, vea la entrada Razor Intellisense and ReSharper del blog de Hadi Hariri, donde se explican formas de usarlos conjuntamente en la actualidad. Durante la instalacin, el cuadro de dilogo de aceptacin del CLUF muestra los trminos de licencia en una ventana que es menor de lo esperado. Cuando se est editando una vista de Razor (archivo .cshtml o .vbhtml), la seleccin de un fragmento de cdigo para ASP.NET MVC mostrar fragmentos de cdigo para vistas .aspx. ASP.NET MVC 3 no incluye ningn fragmento de cdigo para vistas de Razor. Si instala ASP.NET MVC 3 para Visual Web Developer Express en un equipo donde no est instalado Visual Studio, y despus instala Visual Studio, debe reinstalar ASP.NET MVC 3. Visual Studio y Visual Web Developer Express comparten componentes que el instalador de ASP.NET MVC 3 actualiza. Este mismo problema sucede si instala ASP.NET MVC 3 para Visual Studio en un equipo que no tiene Visual Web Developer Express y despus instala Visual Web Developer Express.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 13 Copyright 2011 Microsoft Corporation

Declinacin de responsabilidades
2011 Microsoft Corporation. Reservados todos los derechos. Este documento se proporciona "tal cual". La informacin y las vistas expresadas en este documento, incluidas las direcciones URL y otras referencias a sitios web de Internet, pueden cambiar sin previo aviso. Usted asume el riesgo de usarlas. Este documento no le proporciona ningn derecho legal sobre ninguna propiedad intelectual de ningn producto de Microsoft. Puede copiar y usar este documento para su uso interno de referencia.

Notas de la versin de ASP.NET MVC 3 Tools Update Pgina 14 Copyright 2011 Microsoft Corporation