Elemento PropertySchema (Tipos de Campo)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Representa o esquema de determinadas propriedades variáveis especiais de um tipo de campo personalizado, com cada propriedade definida como um elemento Field .

<PropertySchema>
</PropertySchema>

Importante

Este tópico descreve a marcação usada em um método obsoleto de renderização de propriedades de tipo de campo personalizadas. Ele é fornecido apenas para ajudar na depuração de propriedades de tipo de campo personalizadas desenvolvidas em relação a versões anteriores do SharePoint Foundation. Para obter informações sobre o método recomendado, consulte Renderização de propriedade de tipo de campo personalizado.

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Nenhuma

Elementos filho

Elemento Fields (Esquema de Propriedade de Tipos de Campo)

Elementos pai

Elemento FieldType (Tipos de Campo)

Comentários

Os tipos de campo personalizados podem ter propriedades especiais cujo valor variará de uma coluna com base no tipo de campo para outra coluna com base no mesmo tipo de campo. Considere um tipo de campo de expressão regular personalizado projetado para conter valores string que correspondam a uma determinada expressão regular, como ^(\d{3})\d{3}-\d{4}$ para números de telefone americanos.

Em vez de criar tipos de campo de expressão regulares separados para números de placas britânicas, números de segurança social americanos, números de telefone chineses etc., é mais eficiente criar um único tipo de campo de expressão regular e permitir que os usuários que criam colunas com base no tipo de campo definam a expressão regular que precisa ser correspondida em uma base coluna por coluna. Por exemplo, um usuário que cria uma coluna "Número de Telefone dos EUA" definiria a expressão regular da coluna como a cadeia de caracteres acima. Outro usuário, criando uma coluna "Caixa postal brasileira" definiria a expressão regular de sua coluna como ^\d{5}\-\d{3}$.

Para fazer isso, o campo personalizado precisa ter uma propriedade RegularExpression renderizada em um controle editável na interface do usuário (interface do usuário) quando uma nova coluna é criada. No SharePoint Foundation, isso está na seção Configurações adicionais de coluna na página Nova Coluna do Site e na página Criar Coluna . O elemento PropertySchema no arquivo é onde fldtypes*.xml essas propriedades variáveis são declaradas e recebem um esquema de renderização padrão. Opcionalmente, eles também podem receber valores padrão.

Observação

Se você definir as propriedades variáveis do tipo de campo personalizado no elemento PropertySchema , o SharePoint Foundation renderizará automaticamente essas propriedades com base no esquema.

Exemplo

O exemplo a seguir define um esquema de propriedade para um tipo de campo personalizado chamado RegularExpressionMatch. O esquema declara um campo para uso por criadores de colunas quando eles baseiam uma coluna no tipo de campo. A finalidade do campo é permitir que um criador de coluna defina uma expressão regular diferente para cada coluna que ela baseia no tipo de campo RegularExpressionMatch.

O campo DisplayName e um texto editável serão exibidos na seção Configurações adicionais de coluna na página Nova Coluna do Site e na página Criar Coluna . O atributo MaxLength define o comprimento máximo, em caracteres, da expressão regular e o DisplaySize define o tamanho do campo que o mantém. Os usuários podem rolar dentro do campo para ver o restante da expressão regular se for maior que DisplaySize.

Nenhum padrão foi definido neste exemplo, mas se o desenvolvedor do tipo de campo soubesse que, na maioria dos casos, seria usado para criar colunas contendo números de telefone americanos, o desenvolvedor poderia definir o padrão como <Default>^(\d{3})\d{3}-\d{4}$</Default>.

O exemplo de código a seguir foi editado para obter clareza.

<FieldType>
  <Field Name="TypeName">RegularExpressionMatch</Field>
  …
  <PropertySchema>
    <Fields>
      <Field Name="RegularExpression"
             DisplayName="Regular Expression To Match"
             MaxLength="500"
             DisplaySize="100"
             Type="Text">
        <Default></Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

Compartilhar via