Diretórios virtuais nas soluções do SharePoint

Saiba como as alterações no sistema de diretório virtual afetam a forma como cria soluções de farm no SharePoint.

Verifique suas soluções compatíveis com o novo sistema do modo de interface do usuário

Quando estiver a utilizar o Software Development Kit (SDK) do Microsoft SharePoint 2010, mas estiver a desenvolver para o SharePoint, existe uma alteração no sistema de diretório virtual que tem de considerar enquanto trabalha. A alteração é um efeito colateral da nova funcionalidade do SharePoint que permite que uma coleção de sites seja executada no modo SharePoint 2010 ou no modo SharePoint. Os modos são chamados de níveis de compatibilidade ouversões de interface do usuário. Para ficheiros nas pastas _layouts virtuais ou _controltemplatesno , o SharePoint tem de utilizar a versão dos ficheiros em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ (por vezes denominado ramo de registo 15) ou nos 14 ramo de registo correspondentes, consoante o modo da coleção de sites. O SharePoint adiciona "/15" ao caminho do diretório virtual logo após o nome do diretório virtual para sinalizar que os ficheiros do SharePoint devem ser utilizados. A ausência dessa seqüência extra indica que arquivos de SharePoint 2010 devem ser usados.

Este novo sistema tem implicações para si à medida que desenvolve soluções e aplicações do SharePoint, especialmente quando está a utilizar o SDK do SharePoint 2010. Em qualquer Suplemento do SharePoint (que só é executado no modo SharePoint) e em qualquer solução do SharePoint que sabe que só será utilizado em coleções de sites executadas no modo SharePoint, tem de adicionar o "/15" a todos os _layouts caminhos virtuais e _controltemplates que criar na sua solução/aplicação. (a menos que o caminho aponte para um ficheiro *.aspx), mesmo que esta cadeia não seja apresentada nas instruções que leu no SDK do SharePoint 2010. Por exemplo, se o SDK do SharePoint 2010 lhe der instruções para utilizar ~/_layouts/images/myimage.pngo , deve utilizar ~/_layouts/15/images/myimage.png quando estiver a desenvolver para o SharePoint.

Se você precisar fazer sua solução compatível com os conjuntos de sites de qualquer modo, você precisa de ramificação lógica para determinar o modo de conjunto de sites atual e construir o caminho virtual da mesma forma. A propriedade CompatibilityLevel, que também está disponível em todos os modelos de objetos de cliente do SharePoint e na interface REST, é um local onde o código pode marcar para o modo. A classe SPUtility também tem várias novas propriedades para auxiliar no gerenciamento de nível de compatibilidade em suas soluções. Eles não estão disponíveis nos modelos de objeto do cliente. Finalmente, há vários controles no SharePoint que expõem uma propriedade UIVersion que seu código também pode usar para encontrar o nível de compatibilidade atual.

Confira também

• Criar soluções de farm do SharePoint

• Planear a Implementação de Soluções de Farm para o SharePoint

• SPUtility properties