Procedimiento para establecer el marco de destino y CPU correctos

  • Artículo

Última modificación: viernes, 30 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este tema se explica cómo establecer el Microsoft .NET Framework de destino correcto y la plataforma CPU de destino correcta para los proyectos de desarrollo de Microsoft SharePoint Foundation en Microsoft Visual Studio.

Reglas de definición de destinos

Las reglas para establecer el Microsoft .NET Framework y la plataforma CPU de destino son las siguientes:

  • Todos los proyectos de Visual Studio desarrollados en relación con los modelos de objetos cliente o de servidor de SharePoint Foundation deben establecer Microsoft .NET Framework 3.5 como marco de destino. Esta regla se aplica incluso si el tipo de proyecto de Visual Studio no es uno de los tipos de proyecto de SharePoint 2010.

  • Todos los proyectos de Visual Studio desarrollados en relación con el modelo de objetos de servidor de SharePoint Foundation y, por lo tanto, cualquiera de los tipos de proyecto de SharePoint 2010, deben establecer x64 o Cualquier CPU como plataforma CPU de destino. Cada opción tiene sus ventajas y desventajas.

    • x64 es la opción más precisa, ya que una solución que se desarrolla en relación con el modelo de objetos de servidor de SharePoint Foundationno puede tener como destino "cualquier" CPU. Sin embargo, para elegir como destino x64, debe repetir el procedimiento llamado Para habilitar x64 como plataforma CPU de destino (incluido más adelante en este tema) para cada solución de Visual Studio dirigida a x64. Además, debido a que algunos ensamblados de Microsoft habitualmente llamados, como System.Data.dll y mscorlib.dll, se compilan para Cualquier CPU, pueden aparecer advertencias del compilador (no errores) de que un ensamblado al que se hace referencia está dirigido a un procesador diferente.

    • Cualquier CPU. es la opción más sencilla, ya que siempre está disponible como opción y no se requiere ningún procedimiento especial para habilitarla. Sin embargo, esta opción es un poco engañosa, ya que parece implicar, falsamente, que el ensamblado resultante podría usarse en un equipo x86. Además, los ensamblados producidos para Cualquier CPU pueden ocupar más espacio en disco que los ensamblados generados para x64.

    Nota de precauciónPrecaución

    Si un proyecto dirigido al modelo de objetos de servidor se establece en la plataforma CPU de destino x86, por lo general no se produce un error del compilador. No obstante, se obtendrán errores de tiempo de ejecución y comportamiento en tiempo de ejecución inesperado. Por ejemplo, el código que obtiene una referencia al objeto SPFarm de SharePoint Foundation devuelve null y el código que obtiene una referencia a los objetos secundarios, como la aplicación web, produce excepciones FileNotFoundException.

  • Un proyecto de Visual Studio desarrollado en relación con el modelo de objetos de cliente normalmente debe establecerse en Cualquier CPU como plataforma CPU de destino, ya que normalmente es deseable que las aplicaciones cliente se ejecuten en equipos x86 y x64. Sin embargo, puede especificar x86 o x64 si la aplicación está diseñada para ejecutarse en un único tipo de equipo cliente. Para establecer como destino x64, debe seguir los pasos enumerados en el procedimiento Para habilitar x64 como plataforma CPU de destino más adelante en este tema.

  • Una solución de Visual Studio puede contener varios proyectos. Además, la misma solución, puede tener un tipo de proyecto de SharePoint 2010, así como otros proyectos que no son tipos de proyecto de SharePoint 2010. Si un proyecto de 2010 SharePoint hace referencia a otro tipo de proyecto, o viceversa, deben tener la misma plataforma CPU de destino. Por ejemplo, si la solución es una aplicación de consola que se ejecuta en servidores de SharePoint Foundation, es conveniente aprovechar la funcionalidad de implementación y retirada automática de los tipos de proyecto de SharePoint 2010. En este caso, la solución de Visual Studio puede tener un proyecto de SharePoint vacío y un proyecto de aplicación de consola. Agregue el archivo ejecutable de la aplicación de consola al paquete del proyecto de SharePoint mediante la característica Agregar ensamblados adicionales de la ficha Avanzadas de la ventana de propiedades del paquete. Cuando se agrega el proyecto de aplicación de consola, su valor predeterminado es x86 como plataforma CPU de destino, pero el valor predeterminado del proyecto de SharePoint vacío (al igual que todos los tipos de proyecto de SharePoint 2010) es Cualquier CPU. Después de agregar el archivo ejecutable al paquete, obtendrá un error del compilador hasta que los dos proyectos se establezcan en la misma plataforma CPU de destino. Debe cambiar la aplicación de consola a Cualquier CPU, o bien cambiar ambos proyectos a x64.

Para habilitar x64 como una plataforma CPU de destino

  1. Una vez creado el proyecto, en la barra de herramientas de Visual Studio, abra el cuadro de lista desplegable Plataformas de solución.

  2. Haga clic en Administrador de configuración.

  3. En el diálogo Administrador de configuración, abra el cuadro de lista desplegable Plataforma de soluciones activas y haga clic en <Nuevo> … .

  4. En el diálogo Nueva plataforma de solución, seleccione x64 en el cuadro de lista desplegable Escriba o seleccione la nueva plataforma.

  5. Seleccione x86 en el cuadro de lista desplegable Copiar configuración de.

  6. Haga clic en Aceptar.

  7. En el diálogo Administrador de configuración, asegúrese de que el cuadro de la columna Compilación está activado para todos los proyectos de la solución.

  8. Haga clic en Cerrar.