Elemento RenderPattern (Tipos de Campo)
Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Importante
Este tópico descreve a marcação que foi usada em um método agora obsoleto de renderizar tipos de campos personalizados em exibições de lista e nos formulários Exibir, Editar e Novo. Ele é fornecido exclusivamente para ajudar as pessoas que estão depurando um tipo de campo personalizado que foi originalmente desenvolvido em relação a uma versão anterior do SharePoint Foundation. Para obter informações sobre os métodos recomendados, consulte Modelos de renderização de campo e padrões de renderização de campo personalizado.
Campos personalizados cuja renderização é definida com marcação RenderPattern ainda são renderizados corretamente em formulários. No entanto, o SharePoint Foundation, por padrão, usa folhas de estilos XSLT para renderizar campos em exibições de lista, mesmo para campos personalizados herdados cuja renderização de exibição de lista é definida com um RenderPattern. Para habilitar a renderização desse campo, <Field Name="CAMLRendering">TRUE</Field> um elemento deve ser adicionado ao elemento FieldTypes que o contém no arquivo de definição de tipo de campo (fldtype*.xml).
RenderPattern define a CAML (Collaborative Application Markup Language), HTML e script reais que o SharePoint Foundation pode usar para renderizar o tipo de campo na interface do usuário. Além disso, em exibições de lista, esse elemento renderiza os cabeçalhos de coluna, com base no tipo de campo selecionado.
<RenderPattern Name="Text">
</RenderPattern>
Elementos e atributos
As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.
Atributos
| Atributo | Descrição |
|---|---|
| Nome |
String necessário. Representa o nome do padrão de renderização que você está definindo neste elemento RenderPattern . Os valores válidos são: - HeaderPattern. Define a renderização para o cabeçalho da coluna em páginas de exibição de lista quando a renderização CAML é ativada ( <Field Name="CAMLRendering">TRUE</Field>incluindo no elemento FieldTypes que o contém).fldtypes*.xml- DisplayPattern. Define a renderização do campo para o formulário De exibição (item de lista). Quando a renderização CAML é ativada ( <Field Name="CAMLRendering">TRUE</Field> incluindo no elemento FieldTypes fldtypes*.xml que o contém do arquivo), o DisplayPattern também define a renderização do campo nas páginas de exibição de lista.- EditPattern. Define a renderização do campo para o formulário Editar (item de lista). - NewPattern. Define a renderização do campo para o formulário Novo (item de lista). - PreviewDisplayPattern. Define, para uso em um designer de site WYSIWYG ("o que você vê é o que você obtém") como o SharePoint Designer, uma visualização de como o campo será exibido no modo de exibição usando dados fictícios. - PreviewEditPattern. Define, para uso em um designer de site WYSIWYG, como o SharePoint Designer, uma visualização de como o campo será exibido no modo De edição usando dados fictícios. - PreviewNewPattern. Define, para uso em um designer de site WYSIWYG, como o SharePoint Designer, uma visualização de como o campo será exibido no modo Novo usando dados fictícios. |
Elementos filho
Nenhum definido explicitamente, mas esse elemento é um contêiner de marcação CAML do esquema De exibição.
Elementos pai
Comentários
Herança de RenderPatterns
Se um RenderPattern com um valor de Nome específico não for fornecido para um tipo de campo, o tipo de campo herdará o RenderPattern com esse nome de seu tipo de campo pai.
HeaderPattern
Se a renderização CAML estiver habilitada, o tipo de campo deverá ter um tipo HeaderPattern do elemento RenderPattern , diretamente ou por herança, ou o cabeçalho da coluna do campo nas exibições de lista não será renderizado. A marcação em um HeaderPattern pode ser bastante simples quando o tipo de campo não pode ser classificados ou filtrados. No entanto, se o tipo de campo puder ser classificados ou filtrados, a marcação poderá se tornar bastante complexa porque o cabeçalho serve não apenas como o título da coluna, mas também como um controle de menu suspenso para classificação e filtragem. Além disso, como a capacidade de ser classificada e filtrada pode ser desabilitada para colunas específicas (mesmo quando o tipo de campo no qual a coluna se baseia dá suporte), a marcação deve usar elementos Switch para testar se a classificação ou filtragem está habilitada para a coluna. Para obter exemplos, consulte %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML\FLDTYPES.XML.
DisplayPattern
Se a renderização CAML estiver habilitada, um tipo de campo deverá ter um tipo DisplayPattern do elemento RenderPattern (por herança, se não diretamente) para que o campo possa ser renderizado em exibições de lista. Isso não é necessário para renderizar o campo no modo de exibição, como na página Exibição (item de lista), porque um campo também pode ser renderizado no modo de exibição por meio de um controle de renderização (arquivo .ascx). Nenhum dos tipos de campo herdados fornecidos com o SharePoint Foundation usa um controle de renderização em vez de um tipo DisplayPattern do elemento RenderPattern para renderizar o campo no modo de exibição.
O tipo DisplayPattern de RenderPattern também pode ser usado para renderizar o campo em cada linha de um modo de exibição de lista. Por padrão, o SharePoint Foundation usa marcação fldtypes*.xsl XSLT em um arquivo localizado em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\XSL para renderizar campos em exibições de lista. fldtypes*.xml Mas o arquivo em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML <Field Name="CAMLRendering">TRUE</Field> é verificado quanto à presença do elemento FieldTypes que o contém para o campo. Se ele estiver presente, DisplayPattern será usado para renderizar o campo em exibições de lista.
Observação
Dois tipos de campo herdados fornecidos com o SharePoint Foundation não têm um tipo DisplayPattern de RenderPattern no FLDTYPES.XML: (1) campos ContentTypeId nunca são visíveis. ( 2) Os campos computados são renderizados em exibições de lista e no modo de exibição por um elemento DisplayPattern em seus elementos Field dentro do schema.xml de cada lista na qual aparecem.
NewPattern e EditPattern
Os tipos NewPattern e EditPattern de RenderPattern foram usados para renderizar um campo no modo Novo e no modo De edição, respectivamente, quando o campo não exigia processamento de dados significativo ou validação de dados quando um item de lista que contém o campo estava sendo criado ou editado. Campos de nota de forma livre, por exemplo, não podem ser validados porque qualquer texto é um valor válido. Da mesma forma, campos De escolha e campos de Pesquisa, por definição, limitam as opções do usuário a apenas valores válidos. Outros campos, como Conversor de Moedas e DateTime, precisam apenas de validação mínima que possa ser codificada no script.
Para obter exemplos de tipos NewPattern e EditPattern de RenderPatterns, consulte %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\XML\FLDTYPES.XML.
RenderPatterns para tipos de campo personalizado derivados de várias colunas
Na marcação RenderPattern de um campo MultiColumn personalizado, o atributo SubcolumnNumber de um elemento Column é usado para especificar uma coluna individual em um tipo de campo de várias colunas. Para obter mais informações sobre tipos de campo de várias colunas, consulte Classes de campo multicoluna personalizadas.
Exemplo
O exemplo a seguir define um padrão de renderização de exibição para um tipo de campo personalizado que herda do tipo MultiColumn. O campo é usado para armazenar endereços americanos. A primeira subcoluna armazena o endereço da rua seguido por uma quebra de linha HTML. A próxima subcoluna armazena o nome da cidade seguido por uma vírgula e um espaço. A terceira subcoluna armazena o estado e, após um espaço, a última subcoluna armazena o cep.
<RenderPattern Name="DisplayPattern">
<Switch>
<Expr><Column/></Expr>
<Case Value="">
</Case>
<Default>
<Column SubColumnNumber="0" HTMLEncode="TRUE"/>
<HTML><![CDATA[<BR>]]></HTML>
<Column SubColumnNumber="1" HTMLEncode="TRUE"/>
<HTML><![CDATA[, &nbsp;]]></HTML>
<Column SubColumnNumber="2" HTMLEncode="TRUE"/>
<HTML><![CDATA[ &nbsp;]]></HTML>
<Column SubColumnNumber="3" HTMLEncode="TRUE"/>
</Default>
</Switch>
</RenderPattern>