Elemento field (Lista)

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

Define os tipos de dados internos usados na infraestrutura de lista de um site do SharePoint. Um campo é uma coluna ou atributo de informações que um usuário pode adicionar a uma lista.

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"
  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"
  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"
  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"
  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"
  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"
  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"
  LinkToItemAllowed = "Text"
  List = "Text"
  ListItemMenu = "TRUE" | "FALSE"
  ListItemMenuAllowed = "Text"
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number"
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"
  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"
  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text"
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"
  Version = "Text"
  Viewable = "TRUE" | "FALSE"
  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

Elementos e atributos

As seções a seguir descrevem atributos, elementos filho e elementos pai:

Atributos

Elementos filho

• ESCOLHAS
• Personalização
• Padrão
• DefaultFormula
• DisplayBidiPattern
• DisplayPattern
• FieldRefs
• Fórmula
• FormulaDisplayNames
• MAPEAMENTOS
• Validação

Elementos pai

• Fields
• ProjectedFields

Occurrences

• Mínimo: 0
• Máximo: desvinculado quando o pai é Fields. Quando o pai é ProjectedFields, o máximo é a diferença entre o número máximo de campos permitidos na lista primária que está sendo consultado e o número de campos já na lista.

Comentários

Para criar uma definição de campo personalizada para uma definição de lista baseada em um tipo de campo padrão do SharePoint Foundation, use o elemento Campo (Lista – Definição) em um arquivo Schema.xml .

Para criar uma definição de campo personalizada como um recurso plugável que se baseia em um tipo de campo padrão e que pode ser reutilizado entre sites e listas dentro de uma coleção de sites, use o elemento Campo (Campo) para definir uma coluna de site personalizada.

Para criar um tipo de campo personalizado que implementa uma classe personalizada para validação de dados especiais e renderização de campo, use o elemento Campo (Tipos de Campo).

Os campos podem ser referenciados a partir de definições de exibição, bem como de expressões em elementos de renderização de campo computado. Use o elemento Campo (Exibição) para retornar um valor de campo formatado para exibição dentro de uma exibição e use o elemento Coluna (Exibição) para retornar o valor bruto de dados do campo.

A sintaxe para referenciar um campo é a seguinte:

<Field Name="FieldName"/>

Por padrão, o campo é renderizado com os atributos padrão para essa definição de campo, conforme especificado na tabela anterior. Qualquer um dos atributos de campo pode ser substituído na marcação CAML do atributo FieldRef , que substitui a definição dada para o próprio campo (o atributo Type para um campo não pode ser alterado).

Para exibir o nome de exibição definido pelo usuário de um campo, você pode usar <Property Select="DisplayName"/>.

Em uma enumeração de elemento Fields , o atributo Name pode ser omitido. Para algumas referências de campo, os dados brutos armazenados para o campo podem ser acessados usando <Column/>.

Algumas propriedades de campos de formulários e de determinados aspectos da interface do usuário de criação podem ser renderizadas por meio do elemento Propriedade , por exemplo, <Property Select="Description"/> ou <Property Select="Type"/>. Esses elementos simplesmente recuperam o valor de qualquer atributo de campo ou elemento filho (Propriedade) pelo nome.

Além dos tipos anteriores, os seguintes campos predefinidos são usados com o elemento Field :

Exemplo

O exemplo a seguir usa o elemento Field para especificar opções para uma lista chamada Lista de áreas:

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>

Confira também

• Elemento Coluna (Exibição)
• Elemento Column2 (Exibição)
• Elemento field (Campo)
• Elemento field (Exibição)
• Elemento field (Site)
• Elemento field (Tipos de Campo)
• Elemento field (Esquema de propriedade tipos de campo)
• Elemento field (DeploymentManifest – DeploymentFieldTemplate)
• Elemento field (DeploymentManifest – FieldDataCollection)
• Elemento field (DeploymentManifest – SPFieldCollection)