Elemento RenderPattern (tipos de campos)

Artigo
11/27/2008

Define o real Colaboração Application Markup Language (CAML), HTML e script que Windows SharePoint Services 3.0 podem usar, como um alternativo para um processamento controle modelo (arquivo .ascx), para processar o tipo de campo no interface do usuário. Além disso, nos modos de exibição lista, esse elemento processa cabeçalhos de coluna, baseia a tipo de campo selecionado.

                    
                      
<RenderPattern name="Text">
</RenderPattern>

Atributos

Atributo	Descrição
Name	Necessários Seqüência de caracteres . Representa o nome do padrão de processar que você está definindo neste elemento RenderPattern RenderPattern. Os valores válidos são HeaderPattern. Define processamento para o cabeçalho de coluna em páginas exibição de lista. DisplayPattern. Define processamento do campo para a forma Exibir (item da lista) e para páginas exibição de lista. EditPattern. Define processamento do campo para a forma Editar (item da lista). NewPattern. Define processamento do campo para a forma novo (item da lista). PreviewDisplayPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) (" o que você vê é o que você get ") designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no modo de exibição com dados fictícios. PreviewEditPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no modo Editar com dados fictícios. PreviewNewPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no novo modo com dados fictícios.

Name

Necessários Seqüência de caracteres . Representa o nome do padrão de processar que você está definindo neste elemento RenderPattern RenderPattern.

Os valores válidos são

HeaderPattern. Define processamento para o cabeçalho de coluna em páginas exibição de lista.
DisplayPattern. Define processamento do campo para a forma Exibir (item da lista) e para páginas exibição de lista.
EditPattern. Define processamento do campo para a forma Editar (item da lista).
NewPattern. Define processamento do campo para a forma novo (item da lista).
PreviewDisplayPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) (" o que você vê é o que você get ") designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no modo de exibição com dados fictícios.
PreviewEditPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no modo Editar com dados fictícios.
PreviewNewPattern. Define, para uso em um WYSIWYG (What You See Is What You Get, O formato exibido é o resultado final) designer site such as Microsoft Office do SharePoint Designer 2007, um visualizar de como o campo será aspecto no novo modo com dados fictícios.

Elementos filho

Nenhum explicitamente definido, mas esse elemento é um contêiner de marcação CAML camlshort a partir de O modo de exibição esquema

Elementos pai

Elemento FieldType (tipos de campos)

Comentários

A herança de RenderPatterns

Se um RenderPattern com um determinado Name não é fornecido para um tipo de campo, o tipo de campo herda o RenderPattern com esse nome da sua tipo de campo pai.

HeaderPattern

Todos os tipos campo devem ter um HeaderPattern HeaderPattern tipo de elemento RenderPattern RenderPattern, diretamente ou por herança, porque não há nenhum alternativo sistema para processamento cabeçalhos coluna. A marcação em um HeaderPattern pode ser simples exatamente quando o tipo de campo é não podem ser classificados ou filtrados. No entanto, se os tipo de campo podem ser classificados ou filtrados, em seguida, a marcação poderá ficar bastante complexa porque o cabeçalho serve não apenas como o título para a coluna mas também como um controle drop-down menu para classificação e filtragem. Além disso, como a capacidade de ser Classificado e Filtrado pode ser desativada para colunas específicas (mesmo quando o tipo de campo a coluna baseia suporta-las) a marcação deve usar elementos chave Switch para testar se a classificação ou filtragem é habilitado para a coluna. Consulte C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML\FLDTYPES.XML de exemplos.

DisplayPattern

Um tipo de campo geralmente deve ter um DisplayPattern DisplayPattern tipo de elemento RenderPattern RenderPattern (por herança, se não diretamente) para que o campo pode ser processado em cada linha de um exibição de lista. O DisplayPattern RenderPattern RenderPattern DisplayPattern também é usado para processar mais campos no modo de exibição; Como na página de exibição (item da lista). Como alternativa, um campo pode ser processado no modo de exibição (mas não nos modos de exibição lista) by means of um processamento controle (arquivo .ascx). No entanto, a principal vantagem de usar um controle processamento é fornecer validação de dados e processamento, e essas funções não são necessárias quando os dados (válido ou não) é simplesmente que está sendo exibido no lugar da criado ou editado. Por esse motivo, nenhum dos tipos de campo que enviar com Windows SharePoint Services 3.0 usar um controle processamento em vez de um tipo DisplayPattern DisplayPattern do elemento RenderPattern RenderPattern para processar o campo no modo de exibição. Provavelmente, todos o personalizado tipos campo que você criar usará um DisplayPattern para modo de exibição também.

Observação

Campo dois tipos que enviar com Windows SharePoint Services 3.0 não é necessário um DisplayPattern DisplayPattern de RenderPattern na FLDTYPES.XML: (1) ContentTypeIdOs campos nunca são visíveis.(2)Calculada Os campos são processados na lista Modos de Exibição e no modo de exibição por um elemento DisplayPattern DisplayPattern em seus Field elementos dentro de SCHEMA.XML de cada lista em que aparecem.

NewPattern e EditPattern

O NewPattern e EditPattern EditPattern tipos de RenderPattern são usados para processar um campo no modo novo e modo Editar, respectivamente, quando o campo não requer significativo processamento de dados ou validação de dados quando uma item da lista que contém o campo está sendo criado ou editado. Livre-forma Anotação campos, de exemplo, não podem ser validados porque qualquer texto é um válido valor. Da mesma forma, escolha campos e Pesquisa campos, por definição, limite opções do usuário para válido somente valores. Outros campos, como moeda e de datetime, precisam apenas validação mínima que pode ser codificado no script.

Campos personalizados criados que herdam qualquer um desses tipos podem, no entanto, exigir processamento mais significativo. Nesse caso, usar um controle processamento 12616aab-f427-4abe-9e5b-8b9085a9740e para processar o campo. Em geral, na verdade, o motivo você precisar um personalizado campo é precisamente porque nenhum dos campos que contêm o validação de dados que você precisa enviar com Windows SharePoint Services 3.0.

Consulte C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML\FLDTYPES.XML para exemplos de NewPattern e EditPattern EditPattern tipos de RenderPattern RenderPattern s.

RenderPatterns para tipos de campos personalizados MultiColumn-derivado

No seu RenderPattern RenderPattern marcação para um campo MultiColumn personalizado, use o atributo SubcolumnNumber SubcolumnNumber de um elemento Column colunas para especificar um individual coluna em um tipo de campo de várias colunas. Para obter mais informações sobre tipos campo de várias colunas, consulte Classes do campo personalizado Multicolumn.

Exemplo

O seguinte exemplo define um padrão processamento exibir para um personalizado que herda do tipo de MultiColumn tipo de campo. O campo é usado para armazenar endereços da EUA. A primeira subcolumn armazena o endereço de rua. Isso é seguido por um quebra de linha HTML. O próximo subcolumn armazena o nome de cidade e ele é seguido por uma vírgula e um espaço. A terceira subcolumn armazena o estado e, seguinte um espaço, a última subcolumn armazena a codificar postal.

                    <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>

Consulte também

Tarefas

Walkthrough: Criar um tipo de campo personalizado

Conceitos

Tipos de campo personalizado
Classes do campo personalizado
Processamento da propriedade Tipo do campo personalizado
Definição Tipo de campo personalizado
Classes do campo personalizado Multicolumn

Compartilhar via