Como a: Personalizar XSL para a Web Part de Conteúdo da consulta

Você pode usar a Web Part de Conteúdo da consulta para agregado de conteúdo de múltiplo fontes dados em seu site e presente, em seguida, todos em um local. Antes de configurar e personalizar o Content Query Web Part, você deve considerar o design marca e site desejar para atingir. Microsoft Office do SharePoint Server 2007 inclui três arquivos Extensible Style Language (XSL) que você pode modificar para processar campos estilos que usa a Web Part de Conteúdo da Consulta para exibir o de conteúdo-agrega.

Este tópico identifica os três arquivos XSL a Web Part de Conteúdo da consulta usa e descreve como eles trabalho; Identifica os modelos e variáveis que você pode modificar; e descreve como modificar os arquivos para que a Web Part de Conteúdo da consulta processa dados com o aspecto e sensação que você especificar.

A seguinte tabela relaciona e descreve os três arquivos XSL que descrevam a Web Part de Conteúdo da consulta.

Arquivo	Local	Descrição
ContentQueryMain.xsl	\Style Library\XSL Style Sheets\ContentQueryMain.xsl	Contém a lógica que gera o apropriado chamadas para os modelos de cabeçalho e do item para cada item. Contém funções que ajudam os designers modificar as transformações do item e Header XSLT. Recebe todos o de conteúdo, analisa-lo e envia apropriado pieces aos modelos ItemStyle e cabeçalho. Mantém a estrutura da Content Query Web Part. Armazena dados recuperados quando consultando de conteúdo no caminho /dsQueryResponse/Rows/Row.
ItemStyle.xsl	\Style Library\XSL Style Sheets\ItemStyle.xsl	Contém modelos que definem como para exibir um item. Receber esses modelos e processo uma linha de dados em um tempo, garantindo que o estilo e dados nas linhas de item é consistente. Você pode recuperar dados sobre uma linha usando a @Property@Property.
Header.xsl	\Style Library\XSL Style Sheets\Header.xsl	Contém modelos que definem como para exibir um cabeçalho e garantir a consistência dos cabeçalhos GRUPO. Modelos especificados em Header.xsl receber o próximo item linha ao processo, geralmente a primeira linha em um GRUPO, a menos que haja múltiplo colunas. Se não houver múltiplo colunas, os modelos receber a primeira linha da coluna. Você pode recuperar dados sobre o próximo item linha usando a @Property@Property. Você pode usar o parâmetro $Group $ de grupo que contém o nome da coluna GroupBy e o $GroupType que representa o tipo coluna da coluna GroupBy.

Por padrão, a seguinte modelos estão incluídos nos arquivos ItemStyle.xsl e Header.xsl. O arquivo Header.xsl contém definições estilo de grupo, enquanto o arquivo ItemStyle.xsl contém definições que aplicar a linha itens de Content Query Web Part. Esses corresponder estilos para o disponível opções em ato de soltar o estilo de grupo e item - pressionada listas que aparecem quando você escolher estilos na biblioteca de tipo.

Dica

No seguinte tabelas, os modelos estão listadas na ordem aparecem nos arquivos.

Nome do arquivo	Modelo	Conteúdo da consulta da Web Part ação
ItemStyle.xsl	Padrão	LinkImage está à esquerda. LinkTitle é a parte superior. Descrição é abaixo.
ItemStyle.xsl	NoImage	LinkTitle é a parte superior. Descrição é abaixo.
ItemStyle.xsl	TitleOnly	Item contém somente o LinkTitle.
ItemStyle.xsl	Marcadores	Item contém o LinkTitle pré-pended por um marcador.
ItemStyle.xsl	ImageRight	LinkImage consta o direito. LinkTitle é a parte superior. Descrição é abaixo.
ItemStyle.xsl	ImageTop	LinkImage é acima. LinkTitle está no meio. Descrição é abaixo.
ItemStyle.xsl	ImageTopCentered	LinkImage está acima e centralizado. LinkTitle está no meio. Descrição é abaixo.
ItemStyle.xsl	LargeTitle	LinkImage está à esquerda. LargeLinkTitle é a parte superior. Descrição é abaixo.
ItemStyle.xsl	ClickableImage	Contém somente o LinkImage.
ItemStyle.xsl	NotClickableImage	Contém somente imagem, sem um link.
ItemStyle.xsl	FixedImageSize	LinkImage com uma restrição tamanho à esquerda. LinkTitle é a parte superior. Descrição é abaixo.
ItemStyle.xsl	TitleWithBackground	Contém o LinkTitle com um cor do plano de fundo.

Nome do arquivo	Modelo	Conteúdo da consulta da Web Part ação
Header.xsl	DefaultHeader	Exibe o cabeçalho de grupo em tamanho da fonte médio.
Header.xsl	LargeText	Exibe o cabeçalho de grupo está em tamanho da fonte grande.
Header.xsl	SmallText	Exibe o cabeçalho de grupo está em tamanho da fonte pequenas.
Header.xsl	Faixa	Exibe o cabeçalho de grupo com um cor do plano de fundo quadrados.
Header.xsl	Centralizado	Centraliza o cabeçalho de grupo.
Header.xsl	Separador	Insere uma linha entre o cabeçalho de grupo e de conteúdo abaixo.
Header.xsl	Espaço em branco	Insere espaço em branco entre o Group Header e de conteúdo abaixo.

Cada modelo inclui duas seções de processamento instruções:

• <xsl:variable> sections that process the data and ensure correct formatting.

• <div> sections that render the HTML and include the data.

Codificar o modelo para o modelo ImageRight segue, anotadas com comentários:

///Declares an XSL template named ImageRight that

///processes row style elements defined as ImageRight.

- <xsl:template name="ImageRight" match="Row[@Style='ImageRight']"
mode="itemstyle">

///The <xsl:variable> sections process and ensure correct formatting of the data.

///This section declares the variable named SafeLinkUrl, includes instructions to call the OuterTemplate.GetSafeLink function, and includes the LinkUrl expression to scope the call to the UrlColumnName parameter.
  - <xsl:variable name="SafeLinkUrl">
       /// The OuterTemplate.GetSafeLink variable passes in the UrlColumnName that represents the column name containing the ItemUrl.
    - <xsl:call-template name="OuterTemplate.GetSafeLink">
        <xsl:with-param name="UrlColumnName" select="'LinkUrl'" />
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named SafeImageUrl and calls the OuterTemplate.GetSafeStaticUrl function.
  - <xsl:variable name="SafeImageUrl">
    - <xsl:call-template name="OuterTemplate.GetSafeStaticUrl">
        <xsl:with-param name="UrlColumnName" select="'ImageUrl'" /> 
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named SafeImageHtml and calls the OuterTemplate.GetColumnDataForUnescapedOutput function, and passes the 'PublishingRollupImage' and 'Image' parameter values to the template rule.
  - <xsl:variable name="SafeImageHtml">
    - <xsl:call-template name="OuterTemplate.GetColumnDataForUnescapedOutput">
        <xsl:with-param name="Name" select="'PublishingRollupImage'" /> 
        <xsl:with-param name="MustBeOfType" select="'Image'" /> 
      </xsl:call-template>
    </xsl:variable>

///This section declares the variable named DisplayTitle, includes calls to the OuterTemplate.GetTitle function, and passes the @Title and 'LinkUrl' parameter values to the template rule.
  - <xsl:variable name="DisplayTitle">
    - <xsl:call-template name="OuterTemplate.GetTitle">
        <xsl:with-param name="Title" select="@Title" /> 
        <xsl:with-param name="UrlColumnName" select="'LinkUrl'" /> 
      </xsl:call-template>
   </xsl:variable>

///This section declares the variable named LinkTarget and tests whether it should open the target URL in a new window. If the test returns True, then the template rule processes the instruction to open the target URL in a new window.
  - <xsl:variable name="LinkTarget">
      <xsl:if test="@OpenInNewWindow = 'True'">_blank</xsl:if> 
    </xsl:variable>

///The <div> sections define the data to render and provide instructions on how to render it. This code block defines item data, and uses the OuterTemplate.CallPresenceStatusIconTemplate function to verify whether it should create an icon.
- <div class="item">
    <xsl:call-template name="OuterTemplate.CallPresenceStatusIconTemplate" />
///The <xsl:if test> instruction supplies a condition for the XSLT engine to evaluate. If the test evaluates to True after converting it to a Boolean value, the ItemStyle renders the content.
    - <xsl:if test="string-length($SafeImageUrl) = 0 and string-length($SafeImageHtml) != 0">
      - <div class="image-area-right">
          <xsl:value-of disable-output-escaping="yes" select="$SafeImageHtml" /> 
        </div>
      </xsl:if>
    - <xsl:if test="string-length($SafeImageUrl) != 0">
      - <div class="image-area-right">
        - <a href="{$SafeLinkUrl}" target="{$LinkTarget}">
            <img class="image" align="left" border="0"   src="{$SafeImageUrl}" alt="{@ImageUrlAltText}" /> 
          </a>
        </div>
      </xsl:if>
  - <div class="link-item">
    - <a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">
       <xsl:value-of select="$DisplayTitle" /> 
      </a>
      - <div class="description">
          <xsl:value-of select="@Description" /> 
        </div>
     </div>
  </div>
  </xsl:template>

Several functions are available for use in the <xsl:variables> section of the O Office SharePoint Server 2007 XSL files, as described in the following table.

Função	Descrição
OuterTemplate.GetSafeLink	Quando o usuário passa o UrlColumnName( de nome da coluna que contém o ItemUrl ItemUrl valor), essa função retorna um URL que é seguro para exibir para o item. Se o URL não é seguro para exibir, a função retorna um em branco URL. Se o item não é transmitido, a função retornará o CopyUtil URL.
OuterTemplate.GetSafeStaticUrl	Quando o usuário passa em UrlColumnName (o nome da coluna onde a URL está armazenado), se o URL é seguro para exibir, a função retorna o URL. Se o URL não for seguro para exibir e, em seguida, a função retornará um em branco URL.
OuterTemplate.GetColumnDataForUnescapedOutput	Quando o usuário passa em Name (o nome da coluna a partir da qual recuperar os dados), essa função obtém dados coluna para saída unescaped. Quando o usuário passa em MustBeOfType (o tipo esperado coluna), a função retorna o de conteúdo se a coluna for do tipo correto. Caso contrário, ela não retorna os dados.
OuterTemplate.GetTitle	Quando o usuário passa em Title (os dados na coluna Title título), essa função retorna um título. Se for Title em branco, o nome da página um aparece como em branco ou como o título.
OuterTemplate.FormatColumnIntoUrl	Quando o usuário passa o UrlColumnName (o nome da coluna que contém um URL), essa função retorna o URL contido a coluna.
OuterTemplate.FormatValueIntoUrl	Quando o usuário passa em um Value que representa os dados encontrados em um tipo coluna URL Windows SharePoint Services 3.0 wssversion3, a coluna URL Windows SharePoint Services 3.0 wssversion3short retorna a URL e o texto alt. Retorna o URL contido a coluna.
OuterTemplate.Replace	Se o usuário um do seguinte: Passa em Value e representa o seqüência de caracteres para substituir em Passa em Search e representa o seqüência de caracteres para corresponder ao logon Passa em Replace e representa o seqüência de caracteres para substituir a correspondência com Essa função retorna o apropriado pesquisa e substituir texto.
OuterTemplate.GetPageNameFromUrl	Quando o usuário passa em UrlColumnName (a nome da coluna de URL o item), a função retorna a nome da página da URL.
OuterTemplate.GetPageNameFromUrlRecursive	Método auxiliar para GetPageNameFromUrl.
OuterTemplate.GetGroupName	Quando o usuário passa o valor da coluna GroupName GroupName, a função retorna o nome GRUPO o apropriado formato. Se o valor estiver vazio, ele retornará um em branco GRUPO nome. Quando o usuário passa o valor da coluna de GroupType Tipo_de_grupo (o tipo coluna para o GRUPO), a função retorna o nome da página se o tipo é URL.
OuterTemplate.CallPresenceStatusIconTemplate	Se o @SipAddress@SipAddress existe na atual linha, ele gera o apropriado marcação para criar um ícone de presença de Microsoft Office Outlook 2007 Microsoft Office Communicator 2007.

Para adicionar um Content Query Web Part e Content Query Web Part XSL personalizar

1. Navegue para home page do seu site, clique ações site e em seguida, clique Editar Página para verificar fora de página em Edit Mode.

2. Em um do zonas de Web Parts , clique adicionar Web Parts e em seguida, selecione e adicionar um Content Query Web Part.

3. Clique em editar e, em seguida, clique Modificar Web Part compartilhada .

4. Modificar propriedades e adicionar campos para a Web Part de Conteúdo da consulta quando necessário. Para obter mais informações, consulte Como a: Personalizar a Web Part de Conteúdo da consulta usando propriedades personalizadas.

   Dica

   Quando você modificar a Web Part de Conteúdo da consulta, há two drop - down lista no estilos seção: uma para estilo de grupo e outra para estilo do item.Esses itens lista são definidos por modelos nos arquivos ItemStyle.xsl e Header.xsl.

5. Modifique os valores de instruções de seleção, variáveis e expressões pela edição de XSL, usando as informações de referência neste tópico como um guia. For example, you can modify values of select statements in the <div> section to instruct the expression to resolve to another variable.

Para criar um estilo item

1. Identificar um estilo semelhante a um você desejar criar.

2. Copiar o estilo e alteração de name e match propriedade valores:

   <xsl:template name="ImageRight" match="Row[@Style='ImageRight']" mode="itemstyle">
   <xsl:template name="ImageRight2" match="Row[@Style='ImageRight2']" mode="itemstyle">
   

Consulte também

Outros recursos

Como a: Personalizar a Web Part de Conteúdo da consulta usando propriedades personalizadas
Como a: Personalizar o RSS para a Web Part de Conteúdo da consulta
Como a: exibir campos personalizados em um conteúdo consulta da Web Part