Directorios virtuales en soluciones de SharePoint
Obtenga información sobre cómo afectan los cambios en el sistema de directorios virtuales a cómo se crean soluciones de granja de servidores en SharePoint.
Hacer que las soluciones sea compatible con el nuevo sistema de modo de interfaz de usuario
Cuando usa el Kit de desarrollo de software (SDK) de Microsoft SharePoint 2010, pero desarrollando para SharePoint, hay un cambio en el sistema de directorios virtuales que debe tener en cuenta a medida que trabaja. El cambio es un efecto secundario de la nueva característica de SharePoint que permite que una colección de sitios se ejecute en el modo de SharePoint 2010 o en el modo de SharePoint. Los modos se denominan niveles de compatibilidad oversiones de la interfaz de usuario. Para los archivos de las carpetas _layouts virtuales o _controltemplates, SharePoint debe usar la versión de los archivos en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ (a veces denominado subárbol 15) o en el subárbol 14 correspondiente, en función del modo de la colección de sitios. SharePoint agrega "/15" a la ruta de acceso del directorio virtual justo después del nombre del directorio virtual para indicar que se deben usar los archivos de SharePoint. La ausencia de esa cadena adicional indica que se deben usar los archivos de SharePoint 2010.
Este nuevo sistema tiene implicaciones para usted a medida que desarrolla soluciones y aplicaciones de SharePoint, especialmente cuando usa el SDK de SharePoint 2010. En cualquier complemento de SharePoint (que solo se ejecute en modo de SharePoint) y en cualquier solución de SharePoint que sepa que solo se va a usar en colecciones de sitios que se ejecutan en modo de SharePoint, debe agregar el "/15" a todas las rutas de acceso virtuales y _controltemplates que cree en la _layouts solución o aplicación. (a menos que la ruta de acceso apunte a un archivo *.aspx), aunque esta cadena no aparezca en ninguna de las instrucciones que lea en el SDK de SharePoint 2010. Por ejemplo, si el SDK de SharePoint 2010 le indica que use ~/_layouts/images/myimage.png, debe usar ~/_layouts/15/images/myimage.png al desarrollar para SharePoint.
Si necesita que la solución sea compatible con las colecciones de sitios de cualquiera de los modos, necesite bifurcación lógica para determinar el modo de la colección de sitios actual y construir la ruta de acceso virtual según corresponda. La propiedad CompatibilityLevel , que también está disponible en todos los modelos de objetos de cliente de SharePoint y la interfaz REST, es un lugar donde el código puede comprobar el modo. La clase SPUtility también tiene varias propiedades nuevas para mejorar el nivel de compatibilidad en las soluciones de administración. No están disponibles en los modelos de objetos de cliente. Por último, existen varios controles de SharePoint que exponen una propiedad UIVersion que también puede usar el código para encontrar el nivel de compatibilidad actual.
Nota:
[!NOTA] Si el archivo en la ruta de acceso virtual es *.aspx, SharePoint automáticamente detectar el modo de la colección de sitios actual y devolver el archivo desde el subárbol correcto. Por lo que no es necesario que insertar el "/ 15" en la ruta de acceso virtual.