Compartilhar via

Como a: Personalizar o lógico de controle de etiqueta variações

  • Artigo

Cada um do mestre usar como padrão páginas que está disponível em Microsoft Office do SharePoint Server 2007 para editoração sites ? como Default.Master, LeftNavFlyouts.Master, Stacked.Master e TopNavFlyouts.Master?Contain uma referência a um arquivo chamado VariationsLabelMenu.ascx por um elemento DelegateControl em seu marcação, como mostrado aqui.

<SharePoint:DelegateControl runat="server" ControlId="VariationsFlagControl" />

O arquivo VariationsLabelMenu.ascx contém a lógica para processar variação rótulos em uma página. O controle rótulo variação é um controle usuário em uma página variação. Ele exibe o correspondente variação páginas que estão disponível para essa página para que o usuário possa rapidamente navegar para o outro disponível variações da página.

The VariationsLabelMenu.ascx file is defined in the path \<Program Files>\Common Files\Microsoft Shared Debug\Web Server Extensions\12\Template\ControlTemplates. The publishing feature in O Office SharePoint Server 2007 registers the DelegateControl element in \<Program Files>\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES\Publishing\VariationsFlagControl.xml. Esta arquivo XML aponta para o arquivo VariationsLabelMenu.ascx, que faz com que todos os sites configurados com o modelo site "Corporate Intranet" para que o processamento fornecido pelo VariationsLabelMenu.ascx. Isso também faz com que o página mestra Default.Master para todas as coleções site no farm de servidor para conter o mesmo processamento fornecido pelo VariationsLabelMenu.ascx. Porque o arquivo VariationsFlagControl.xml reside em sistema de arquivos servidor Web de front-end, o processamento não pode variar de coleção site a site coleção.

Você pode personalizar a lógica controle rótulo usar como padrão variações de uma destas três maneiras. Cada abordagem tem suas próprias vantagens e desvantagens, e você deve considerá-las cuidadosamente antes de decidir qual método usar.

  • Diretamente editar o arquivo VariationsLabelMenu.ascx.

    Essa é a maneira mais rápida para editar a lógica. Você editar a lógica no arquivo VariationsLabelMenu.ascx diretamente como você precisa de sistema de arquivos servidor Web de front-end.

    Dica

    É necessário o arquivo VariationsLabelMenu.ascx em cada um dos servidores de atualização.Todas as coleções site no farm de servidor vai ser ligadas ao personalizado variação raiz rotular lógica você especificar.

  • Crie um arquivo .ascx na página mestra e layouts de galeria de páginas.

    Implementação dessa abordagem é descrita no primeiro procedimento, para criar um arquivo .ascx na Master Page e Page Layouts Gallery . Como o método anterior, este também fornece personalização fácil e rápida a direcionar edição, sem problemas compilação e implantação DLL. Além disso, como cada coleção site usa seu próprio conjunto de página layouts, essa abordagem permite personalização da variação controle rótulo lógica em uma coleção site nível. Ao usar esta abordagem, você também deve atualização o web.config arquivo em cada um dos servidores Web front-end.

    Aviso

    Use cuidado quando configuração o AllowCompilation sinalizador sobre o arquivo VariationsLabelMenu.aspx.Usar codificar interno pode tornar possível para que alguém mal-intencionado inserção codificar para a página.

  • Criar um pré-compilado assembly.

    Implementação desse método é descrita o segundo procedimento, para criar um pré-compilado assembly . Essa abordagem apresenta há risco de segurança relacionado à abertura uma página mestra e Page Layouts Gallery item para execução codificar interno. Como o método de criação arquivo .ascx, personalização é feita em uma coleção site nível. No entanto, cada tempo você precisa alteração a variação lógica controle rótulo, é necessário recompilar o assembly. Como resultado, este método oferece um ciclo implantar alteração - testar - menos rápido.

Dica

Você deve implantar o assembly em todos os servidores Web front-end.

Para criar um arquivo .ascx na página mestra e layouts de galeria de páginas

  1. Carregar VariationsLabelMenu.ascx a página mestra e galeria layouts de páginas da coleção de site.

  2. Para permitir a execução codificar interno do VariationsLabelMenu.ascx na página mestra e layouts de galeria de páginas, modifique o arquivo web.config da seguinte maneira.

      <SharePoint>
     <SafeControls>
       <!-- marks the VariationsLabelMenu.ascx as safe -->
       <SafeControl Src="/_catalogs/masterpage/VariationsLabelMenu.ascx" Safe="True" AllowRemoteDesigner="True" />
     </SafeControls>
     <SafeMode ... >
       <!-- marks VariationsLabelMenu.ascx for ASP.NET compilation -->
       <PageParserPaths>
         <PageParserPath VirtualPath= "/_catalogs/masterpage/VariationsLabelMenu.ascx" 
           CompilationMode="Always"  
           AllowServerSideScript="False"
           AllowUnsafeControls="False" />
       </PageParserPaths>
     </SafeMode>
   </SharePoint>

  3. Substituir as referências ao arquivo VariationsLabelMenu.ascx em sistema de arquivos servidor Web de front-end com referências para o arquivo VariationsLabelMenu.ascx na Master Page e página layouts da Galeria você pode fazer isso em um do seguinte formas:

    • Completamente remover a marcação DelegateControl da página mestra Default.Master e incorporar uma referência a VariationsLabelMenu.ascx na página mestra e Page Layouts Gallery.

    • Tornar um copiar do página mestra Default.Master e renomeá-lo, de exemplo, Default2.master e em seguida, faça seu uso modelo site Default2.master. Em Default2.master, você pode substituir as referências ao arquivo VariationsLabelMenu.ascx em sistema de arquivos servidor Web de front-end com referências para o arquivo VariationsLabelMenu.ascx na página mestra e Page Layouts Gallery.

  4. Para a outra editoração mestre arquivos, você pode substituir as referências para o arquivo VariationsLabelMenu.ascx em sistema de arquivos servidor Web de front-end com referências para o arquivo VariationsLabelMenu.ascx na página mestra e Page Layouts Gallery.

Para criar um pré-compilado assembly

  1. Copiar a codificar do VariationsLabelMenu.ascx e criar um controle composto no seu assembly DLL, usando o VariationsLabelEcbMenu e VariationHierarchicalDataSource VariationHierarchicalDataSource controles como controles filho.

  2. Change the DelegateControl registration in \<Program Files>\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES\Publishing\VariationsFlagControl.xml to point to the composite control you created, which replaces the reference to VariationsLabelMenu.ascx on the front-end Web server file system.

    Você pode também completamente remover a marcação DelegateControl DelegateControl do página mestra Default.Master e incorporar uma referência a controle composto que você criou.

  3. Para a outra editoração mestre arquivos, você pode substituir as referências a VariationsLabelMenu.ascx com referências para o controle composto que você criou.