Elemento field (Campo)

Artigo
04/08/2023

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

Define uma coluna do site.

Definição

<Field
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion="TRUE" | "FALSE"
  AllowDuplicateValues="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"
  Commas="TRUE" | "FALSE"
  Customization=Text
  Decimals="Integer"
  DefaultListField="TRUE" | "FALSE"
  Description="Text"
  Dir="Text"
  DisplaceOnUpgrade="TRUE" | "FALSE"
  DisplayImage="Text"
  DisplayName="Text"
  DisplayNameSrcField="Text"
  DisplaySize=Integer
  Div="Number"
  EnableLookup="TRUE" | "FALSE"
  ExceptionImage="Text"
  FieldRef="Text"
  FillInChoice="TRUE" | "FALSE"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  ForcedDisplay="Text"
  Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
  FromBaseType="TRUE" | "FALSE"
  Group="Text"
  HeaderImage="Text"
  Height="Integer"
  Hidden="TRUE" | "FALSE"
  HTMLEncode="TRUE" | "FALSE"
  ID="Text"
  IMEMode="active | 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"
  List="Text"
  Max="Number"
  MaxLength="Integer"
  Min="Number"
  Mult="TRUE" | "FALSE"
  Name="Text"
  NegativeFormat="MinusSign" | "Parens"
  Node="Text"
  NoEditFormBreak="TRUE" | "FALSE"
  NumLines="Integer"
  Overwrite="TRUE" | "FALSE"
  OverwriteInChildScopes="TRUE" | "FALSE"
  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="Restrict | Cascade | None"
  RenderXMLUsingPattern="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  RestrictedMode="TRUE" | "FALSE"
  ResultType="Text"
  RichText="TRUE" | "FALSE"
  RichTextMode="Text"
  RowOrdinal="Integer"
  Sealed="TRUE" | "FALSE"
  SeperateLine="TRUE" | "FALSE"
  SetAs="Text"
  ShowAddressBookButton="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"
  Viewable="TRUE" | "FALSE"
  Width="Integer"
  WikiLinking="TRUE" | "FALSE"
  XName="Text">
</Field>

Elementos e atributos

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

Atributos

Atributo	Descrição
Agregação	Texto opcional. Usado em um campo agregado em um formulário XML para especificar a função a ser aplicada a uma coleção de valores ou elementos retornados por uma expressão XPath. Se você usar o atributo Node para especificar uma expressão XPath que retorna uma coleção de valores, também poderá incluir um atributo de agregação que especifica a ação a ser tomada no conjunto de valores retornado. Essa ação pode ser uma função de agregação ou uma indicação do elemento específico dentro da coleção. Os valores possíveis incluem o seguinte: soma: adicione os valores. contagem: conte o número de valores. média: localize a média dos valores. min: Localize o valor mínimo. max: localize o valor máximo. mesclagem: mesclar os valores. plaintext: converte o conteúdo do texto do nó em texto sem formatação. primeiro: aplicar promoção e rebaixamento de propriedade ao primeiro elemento da coleção. último: aplicar promoção e rebaixamento de propriedade ao último elemento da coleção. Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PrimaryPIAttribute e PrimaryPITarget são usados para promoção e rebaixamento de propriedade em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
AllowDeletion	Booliano opcional. TRUE se o campo puder ser excluído.
AllowDuplicateValues	Booliano opcional. Especifica se valores duplicados são permitidos em um determinado campo de lista. Definir esse valor como false, o que impede a inserção de valores duplicados, efetivamente faz com que esse campo se comporte como uma chave primária. True se valores duplicados forem permitidos no campo; caso contrário , false. O valor padrão é true.
AllowHyperlink	Booliano opcional. TRUE se os hiperlinks puderem ser usados no campo.
AllowMultiVote	Booliano opcional. TRUE se várias respostas forem permitidas em uma pesquisa.
Appendonly	Booliano opcional. Quando a versão estiver habilitada na lista, TRUE se o texto só puder ser acrescentado ao texto existente no campo Observação .
AuthoringInfo	Texto opcional. Uma cadeia de caracteres descritiva exibida nas páginas de edição de campo para identificar o campo e sua finalidade; por exemplo, o campo LinkTitle tem as informações de criação "(link para item)". Esse atributo geralmente é usado se houver um campo com o mesmo nome para outra finalidade.
Basetype	Opcional. O atributo BaseType pode ser definido como Integer, que armazena valores como inteiros ou como Texto (padrão), que armazena valores como texto. Você não pode criar campos de escolha de tipo base inteiros.
CalType	Inteiro opcional. Especifica o tipo de calendário. Os valores possíveis incluem o seguinte: 16: Era Saka 15: Lunar chinês 14: Lunar coreano e japonês 12: Francês transliterado gregoriano 11: Inglês transliterado gregoriano 10: Árabe gregoriano 9: Francês do Oriente Médio Gregoriano 8: hebraico (lunar) 7: Tailandês 6: Hijri (lunar árabe) 5: Era tangun coreana 4: Era Taiwan 3: Era do Imperador Japonês 1: Gregoriano 0: Nenhum tipo especificado
CanToggleHidden	Booliano opcional. TRUE se o campo puder ser oculto por meio da interface do usuário.
ClassInfo	Texto opcional. Especifica uma classe CSS (folha de estilo em cascata) a ser usada para o campo na exibição de tabela padrão. Se definida, a classe especificada será usada em vez da classe ms-vb2 padrão.
Colname	Texto opcional. Um atributo interno que define o mapeamento do campo para o nome de armazenamento físico desse campo. Este deve ser um nome válido no banco de dados subjacente e deve ser idêntico ao nome usado na tabela de banco de dados. Se não for especificado, o servidor gerará um nome de coluna que não colidirá com nenhum nome de coluna existente e que contém apenas caracteres permitidos pela Microsoft SQL Server.
Vírgulas	Booliano opcional. TRUE se as vírgulas forem usadas para separar milhares.
Personalização	Texto opcional. Fornece a capacidade de adicionar propriedades personalizadas a tipos de campo personalizados.
Decimais	Inteiro opcional. Determina o número de decimais a serem exibidos. O valor exibido é arredondado até a precisão de exibição; por exemplo, 1.05 é exibido como 1.1 quando arredondado para um local decimal.
DefaultListField	Booliano opcional. Obtém um valor que especifica se deve mostrar o formulário Editar Propriedades para um arquivo quando esse arquivo é carregado em uma biblioteca de documentos. True se o campo que está sendo adicionado a uma biblioteca não tiver um formulário visível Editar Propriedades ; caso contrário, false. O padrão é false.
Descrição	Texto opcional. Fornece a descrição mostrada no formulário de edição de uma lista se uma descrição de campo for especificada. Por padrão, os campos no Microsoft SharePoint Foundation não têm descrições.
Dir	Texto opcional. Especifica a direção do texto para um campo que dá suporte à ordem de leitura bidirecional. Os valores possíveis são LTR (da esquerda para a direita), RTL (da direita para a esquerda) e nenhum.
DisplaceOnUpgrade	Booliano opcional. Se já existir uma definição de campo para o campo, TRUE forçará as atualizações às propriedades de campo com os valores especificados nesta definição de campo.
Displayimage	Texto opcional. Especifica o nome de um ícone exibido para a coluna.
DisplayName	Texto opcional. O nome exibido para um campo. Não há restrição no uso de espaços. O comprimento máximo é de 255 caracteres. O valor pode ser uma referência a um recurso no formato $Resources:String. Para obter mais informações, consulte Localizando soluções do SharePoint. O nome de exibição pode ser editado pelo usuário e pode ser alterado após a criação inicial do campo. Esse nome é usado como um título de coluna quando o campo é exibido em uma exibição de tabela e como um rótulo de formulário quando o campo é exibido em um formulário.
DisplayNameSrcField	Texto opcional. Geralmente usado para um campo computado que precisa do mesmo nome que outro campo. Se o campo de origem for modificado e o nome de exibição for alterado por um usuário, o nome de exibição desse campo também será alterado. Essa cadeia de caracteres refere-se ao nome do outro campo.
Displaysize	Inteiro opcional.
Div	Número opcional. Um fator de escala usado na divisão antes de exibir um número. O número de exibição é N * Mult/Div (arredondado até o número especificado por Decimals).
EnableLookup	Booliano opcional. TRUE para habilitar valores de pesquisa no campo.
ExceptionImage	Texto opcional. Usado em um tipo de campo Recorrência para especificar o nome do arquivo de imagem a ser usado para exceções.
Fieldref	Texto opcional. Para um campo de pesquisa secundário, especifica a ID do campo de pesquisa primária do qual ele depende. O valor deve ser a representação de cadeia de caracteres de um GUID sem chaves.
FillInChoice	Booliano opcional. TRUE se o campo permitir que os usuários preencham valores para a coluna.
Filtráveis	Booliano opcional. TRUE se o campo puder ser filtrado.
FilterableNoRecurrence	Booliano opcional. TRUE se um filtro puder ser criado no campo em uma exibição que não expanda eventos recorrentes. Se Filterable contiver TRUE, o campo poderá ser filtrado em todas as exibições, independentemente de como FilterableNoRecurrence é definido.
ForcedDisplay	Texto opcional. Especifica o texto a ser exibido no lugar do valor real do campo. Esse atributo é usado em pesquisas para impedir que o nome de usuário seja exibido.
Format	Texto opcional. Especifica a formatação a ser usada para valores numéricos. Para campos de data/hora, os seguintes valores são possíveis: DateOnly: exibir (e permitir edições para) apenas a parte de data (a parte de hora está definida como 12:00 da manhã para todos os valores editados). DateTime: exibir e editar data e hora do dia (padrão). ISO8601: Exibir data e hora no formato de hora ISO8601 convertido em formato UTC (Tempo Universal Coordenado): YYYYY-MM-DDTHH:MM:SSZ. Esse é o formato usado para propriedades de documento no sistema do Microsoft Office de 2007, bem como para o formato de intercâmbio padrão usado no SharePoint Foundation entre formulários Novos e Editar e o servidor. ISO8601Basic: use a forma abreviada de formatos de data/hora 8601: YYYYYMMDDTHHMMSSZ. Este é o formato usado para vCard/iCal. Para campos Choice, esse atributo pode ser definido como Dropdown (padrão), que fornece opções de edição por meio de uma seleção suspensa ou para RadioButtons, que fornece opções por meio de um grupo de botões de rádio. Para campos de URL, esse atributo pode ser definido como Hyperlink (padrão), que exibe a URL como uma marca normal `<a>` ou para Imagem, que exibe a URL como `<img src="url" alt="Description" />`.
FromBaseType	Booliano opcional. Esse atributo é preterido em favor do atributo Selado .
Group	Texto opcional. Especifica o grupo de colunas ao qual o campo pertence.
HeaderImage	Texto opcional. Especifica o nome de um arquivo de imagem a ser usado como um cabeçalho no campo.
Height	Inteiro opcional. Especifica a altura em pixels das imagens exibidas para usuários na lista Informações do Usuário.
Oculto	Booliano opcional. Se TRUE, o campo estará completamente oculto da interface do usuário. Definir ReadOnly como TRUE significa que o campo não é exibido em formulários Novos ou Editar, mas ainda pode ser incluído em exibições.
Htmlencode	Booliano opcional. TRUE para converter caracteres inseridos para que eles sejam exibidos como texto no navegador; caracteres que podem ser confundidos com marcas HTML são convertidos em entidades.
ID	Texto obrigatório. Identifica exclusivamente o campo. O valor deve ser a representação de cadeia de caracteres de um GUID contido em chaves ({}).
IMEMode	Texto opcional. Especifica o viés de modo IME (Editor de Método de Entrada) a ser usado para o campo. O IME permite a conversão de teclas entre idiomas quando um sistema de gravação tem mais caracteres do que pode ser codificado para o teclado determinado. Os valores possíveis incluem o seguinte: auto: Não usado. Para especificar esse modo IME, defina o valor da propriedade IMEMode como uma cadeia de caracteres vazia (""). ativo: todos os caracteres são digitados por meio do IME, mas os usuários ainda podem desativar o IME. inativo: os caracteres são digitado sem o IME, embora os usuários ainda possam ativar o IME.
Indexado	Booliano opcional. TRUE se a coluna for indexada para uso em filtros de exibição. Observação: embora você possa indexar uma coluna Lookup para melhorar o desempenho, usar uma coluna pesquisa indexada para evitar exceder o limite de exibição de lista não funciona. Para evitar exceder o limite de exibição de lista, use outro tipo de coluna como o índice primário ou secundário.
IsolateStyles	Booliano opcional. Para um campo Text cujo atributo RichText é TRUE e cujo atributo RichTextMode é FullHtml, esse atributo especifica que um servidor reescreverá o HTML do campo para garantir que ele não interfira na renderização da página ao redor.
IsRelationship	Booliano opcional. TRUE se esse campo for retornado pelo método GetRelatedFields() de outra lista.
JoinColName	Texto opcional. Esse atributo é definido apenas para campos de pesquisa. Ele é muito semelhante ao ColName, exceto que ele denota o nome da coluna usada no SQL JOIN entre as listas locais e externas. Normalmente, esse valor não deve ser personalizado. Atualmente, ele é usado apenas no esquema Field de determinados campos internos e de tipo base para denotar pesquisas na tabela URLs (DocMd), que é ingressada na coluna UrlID.
JoinRowOrdinal	Inteiro opcional. Não se destina a ser usado diretamente do código.
JoinType	Texto opcional. Especifica o tipo de JOIN usado no campo. Os valores possíveis incluem INNER, LEFTOUTER e RIGHTOUTER.
LCID	Inteiro opcional. O atributo LCID pode ser usado para especificar o país/região cujo formato de moeda está sendo usado, por exemplo, 1033 para o Estados Unidos. Dois casos especiais envolvem o formato de símbolo euro. Se LCID=-1 (0xFFFFFFF), o símbolo euro será adicionado como um prefixo ao número. Se LCID=-2 (0xFFFFFFE), o símbolo euro será adicionado como sufixo ao número. O número de dígitos decimais é 2, embora isso possa ser substituído pelo atributo Decimals do campo. O símbolo da moeda euro é igual a 0x20AC na UCS-2.
List	Texto opcional. Usado para identificar a lista que é o destino de um campo de pesquisa (Type="Pesquisa"). Se a lista de destino já existir, o valor do atributo List deverá ser a representação de cadeia de caracteres do GUID (incluindo chaves) que identifica a lista de destino. Se o destino for a mesma lista à qual o campo pertence, você poderá especificar "Self". Se a lista de destino ainda não existir, o valor do atributo List poderá ser uma URL relativa à Web, como "Listas/Minha Lista", mas somente se a lista de destino for criada no mesmo recurso que o que cria o campo de pesquisa. Nesse caso, o valor do atributo List no elemento Field deve ser idêntico ao valor do atributo Url no elemento ListInstance que cria a lista de destino.
Max	Número opcional. Especifica o valor máximo permitido para o campo.
MaxLength	Inteiro opcional. Especifica o número máximo de caracteres permitidos em um valor de campo. Os formulários de edição são ajustados para impor esse valor, que é validado no cliente. Se o usuário tentar inserir mais do que o número de caracteres definido por MaxLength, uma mensagem de erro será exibida.
Min	Número opcional. Especifica o valor mínimo permitido para o campo.
Mult	Booliano opcional. TRUE para permitir que um campo de pesquisa contenha vários valores. O padrão é FALSE.
Nome	Texto obrigatório. O nome interno do campo. O nome deve ser exclusivo em relação ao conjunto de campos em uma lista ou site. O SharePoint Foundation alterará o valor, se necessário, para garantir sua exclusividade; caso contrário, ele não muda para o tempo de vida da definição de campo.
NegativeFormat	Texto opcional. Especifica como indicar valores negativos. Pode ser definido como um dos seguintes valores: MinusSign: use o sinal de menos como prefixo. Parens: cerque com parênteses.
Nó	Texto opcional. Usado em formulários XML, esse atributo é necessário para todos os campos, exceto links de PI (instrução de processamento), e especifica a expressão XPath para um nó promovido.
NoEditFormBreak	Booliano opcional. TRUE para evitar que uma quebra de linha seja adicionada entre campos no novo formulário de item ou edite o formulário de item. Alguns tipos de campo, como um campo de texto rico, fornecem espaçamento por padrão e esse atributo permite o controle sobre o espaçamento extra que resulta.
NumLines	Inteiro opcional. Recomenda o número de linhas (linhas) a serem exibidas em um bloco TEXTAREA durante a edição. Essa é apenas uma dica de interface do usuário do cliente — não há nenhuma limitação imposta no número de linhas de texto que podem ser editadas.
Overwrite	Booliano opcional. Especifica se a definição de campo para um novo campo que é ativado em um site (SPWeb) substitui a definição de campo para um campo existente, nos casos em que o novo campo tem a mesma ID de campo que o campo existente. True se o novo campo substituir o campo existente com a mesma ID de campo; caso contrário , false. O padrão é false. Observação: se o campo existente for somente leitura ou se estiver selado, ele não será substituído pelo campo que está sendo ativado, mesmo que esse atributo seja definido como true.
OverwriteInChildScopes	Booliano opcional. Indica se uma definição de campo especificada deve ser substituída quando você estiver provisionando o campo em uma coleção de sites e se essa definição de campo já existe na Web filho desse conjunto de sites. True se a definição de campo deve ser substituída; caso contrário , false. O valor padrão é falso.
Percentage	Booliano opcional. TRUE se o valor for exibido como uma porcentagem; ou seja, um número multiplicado por 100 com um sinal percentual (%) acrescentado.
PIAttribute	Texto opcional. Especifica o atributo na instrução de processamento de documento (especificada pelo atributo PITarget ) a ser usado como o valor da coluna. Usado para promoção e rebaixamento de propriedades em documentos XML. Se você especificar o atributo PIAttribute , também deverá especificar o atributo PITarget . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
Pitarget	Texto opcional. Especifica a instrução de processamento de documento na qual o valor da coluna é armazenado em documentos desse tipo de conteúdo. Usado para promoção e rebaixamento de propriedades em documentos XML. Se você especificar o atributo PIAttribute , também deverá especificar o atributo PITarget . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
PrependId	Booliano opcional. Usado por campos de pesquisa que podem ter vários valores. Especifique TRUE para exibir a ID do item de um item de destino, bem como o valor do campo de destino em Editar e Novos formulários de item.
Presença	Booliano opcional. TRUE se as informações do usuário estiverem presentes para o campo.
PrimaryKey	Booliano opcional. TRUE se o campo for a chave primária na relação entre a lista e outra lista.
PrimaryPIAttribute	Texto opcional. Usado para promoção e rebaixamento de propriedades em documentos XML. Especifica um atributo alternativo na instrução de processamento de documento, especificada pelo PrimaryPITarget, para usar como o valor da coluna. Se você especificar o atributo PrimaryPIAttribute , também deverá especificar o atributo PrimaryPITarget . Se especificado, o SharePoint Foundation usará esses valores antes dos especificados nos atributos PITarget e PIAttribute . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
Primarypitarget	Texto opcional. Especifica uma instrução de processamento de documento alternativa na qual o valor da coluna é armazenado para documentos desse tipo de conteúdo. Se você especificar o atributo PrimaryPIAttribute , também deverá especificar o atributo PrimaryPITarget . Se especificado, o SharePoint Foundation usará esses valores antes dos especificados nos atributos PITarget e PIAttribute . Para obter mais informações sobre como os atributos Node, PIAttribute, PITarget, PIAttribute Primário e PrimaryPITarget são usados para promoção e rebaixamento de propriedades em documentos XML, consulte Usando tipos de conteúdo para especificar propriedades de documento XML.
ReadOnly	Booliano opcional. Se TRUE, o campo não será exibido em Formulários Novos ou Editar, mas pode ser incluído em exibições. Além disso, definir ReadOnly como TRUE oculta o campo das páginas Configurações do Site para gerenciar colunas de site e tipos de conteúdo. Definir o atributo Oculto como TRUE oculta completamente o campo da interface do usuário. Se você não incluir esse atributo, o SharePoint Foundation tratará a coluna como se esse atributo estivesse definido como False.
ReadOnlyEnforced	Booliano opcional. TRUE para especificar que o usuário não pode alterar o campo por qualquer meio e que ele só pode ser alterado pelo sistema.
RelationshipDeleteBehavior	Texto opcional. Especifica uma restrição de exclusão para um campo de pesquisa. Para obter mais informações, consulte a enumeração SPRelationshipDeleteBehavior . Para uma coluna do site, o valor não deve ser Cascata ou Restrição. Pode ser Nenhum (o padrão) ou o atributo pode ser omitido. Se você especificar qualquer valor diferente de Nenhum, também deverá especificar TRUE para o atributo Indexado e FALSE para o atributo Mult .
RenderXMLUsingPattern	Booliano opcional. Usado para campos computados para determinar o formato de exibição. Se TRUE, os valores serão renderizados com base no padrão de exibição do campo computado, em vez do valor da coluna da primeira referência de campo não compatível na qual o campo computado se baseia. Por exemplo, em uma biblioteca de imagens, a coluna Tamanho da Imagem é representada pela largura x altura, mas se esse atributo não for definido como TRUE, apenas a primeira referência de campo, largura, será exibida. Se for definido como TRUE, o formato de largura x altura será exibido.
Required	Booleano obrigatório. Se TRUE, o campo não deve ter um valor vazio atribuído a ele. Se um valor de campo nenhum for dado em uma postagem de formulário, o texto de campo obrigatório padrão ou uma mensagem explicitamente especificada (ou seja, por meio `<ErrorText>` de marcas) será exibido no formulário de erro. Essa validação é tratada apenas pelo cliente (o banco de dados sempre permite NULL para todos os campos definidos pelo usuário).
RestrictedMode	Booliano opcional. TRUE para não permitir que o campo Observação contenha formatação avançada de texto avançada, como imagens, tabelas ou hiperlinks, nem para permitir colar texto formatado no campo.
ResultType	Texto opcional. Especifica o tipo de dados de valores retornados do campo.
RichText	Booliano opcional. TRUE se o campo exibir uma formatação de texto avançada.
RichTextMode	Texto opcional. Uma das opções do enumeração RichTextMode.
RowOrdinal	Inteiro opcional. Especifica o local do banco de dados para o campo.
Selado	Booliano opcional. Definir esse atributo como TRUE para um campo marca o campo como irremovável. A página Alterar Coluna não tem nenhum botão Excluir . Os usuários não podem excluir o campo.
SeparateLine	Booliano opcional. Usado internamente para dar suporte à renderização de um campo (por exemplo, Anotações ou Comentários) em uma linha separada. Esse atributo não se destina ao uso público.
SetAs	Não se destina a ser usado diretamente do código.
ShowAddressBookButton	Não se destina a ser usado diretamente do código.
ShowField	Texto opcional. Quando o atributo Type é "Pesquisa" o valor do atributo ShowField especifica o nome interno do campo de destino a ser pesquisado. Se nenhum valor for especificado, o texto hiperlinkado do campo Título do registro na lista de destino será exibido. Os seguintes tipos de campo são permitidos como o destino de um campo de pesquisa: Contador, DateTime, Número e Texto. O tipo de campo computado pode ser um destino se as pesquisas estiverem habilitadas. Para obter mais informações, consulte a propriedade EnableLookup da classe SPFieldComputed . O tipo de campo Calculado pode ser um destino se a saída for texto. Para obter mais informações, consulte a propriedade OutputType da classe SPFieldCalculated**.
ShowInDisplayForm	Booliano opcional. TRUE para exibir o campo no formulário para exibir o item.
ShowInEditForm	Booliano opcional. TRUE para exibir o campo no formulário para editar o item.
ShowInFileDlg	Booliano opcional. Esse atributo é válido apenas para campos dentro de esquemas de biblioteca de documentos. Se FALSE, o campo não aparecerá na caixa de diálogo da propriedade para salvar formulários que aparecem ao salvar de aplicativos cliente. Por exemplo, o campo Título tem esse atributo porque isso é definido diretamente no documento que está sendo salvo na biblioteca de documentos.
ShowInListSettings	Booliano opcional. TRUE para exibir a coluna na página para personalizar configurações de lista.
ShowInNewForm	Booliano opcional. Se FALSE, o campo não aparece em uma enumeração Campos quando o modo de exibição é definido como Novo. Campos com essa configuração não aparecem na página padrão Novo Item para uma determinada lista. Em particular, isso é usado para ocultar campos na página para carregar documentos na biblioteca de documentos.
ShowInVersionHistory	Booliano opcional. TRUE para exibir a coluna na página para exibir versões do item da lista.
ShowInViewForms	Booliano opcional. TRUE para especificar que o campo é exibido em páginas usadas para exibir dados de lista.
Ordenável	Booliano opcional. TRUE se os valores no campo puderem ser classificados.
Sourceid	Texto opcional. Contém o namespace que define o campo, como `http://schemas.microsoft.com/sharepoint/v3` ou o GUID da lista na qual o campo personalizado foi criado.
StaticName	Texto opcional. Contém um nome interno do campo que pode não ser exclusivo em uma coleção de campos. No entanto, ao contrário do atributo Name , que pode ser alterado para garantir sua exclusividade, o valor do atributo StaticName é atribuído ao campo exatamente como você definiu. Posteriormente, você pode usar esse valor no código para obter uma referência ao campo chamando o método TryGetFieldByStaticName .
StorageTZ	Especifica como os valores de data/hora são armazenados. Quando StorageTZ é definido como UTC, a data/hora é tratada como UTC (Tempo Universal Coordenado). Para denotar que um valor de data/hora se refere à hora "abstrata", o que significa que a data/hora é armazenada no banco de dados conforme inserido pelo usuário sem conversão ou armazenamento do fuso horário local, omita o atributo StorageTZ .
StripWS	Booliano opcional. TRUE se o espaço em branco for removido do início e do fim dos valores de campo.
SuppressNameDisplay	Booliano opcional. TRUE para não exibir o nome do usuário em um campo Usuário .
Textonly	Booliano opcional. Se TRUE, o campo poderá conter apenas valores de texto .
Título	Texto opcional. Contém o título do campo exibido na interface do usuário.
Tipo	Texto obrigatório. O tipo de dados do campo (a menos que o elemento Field seja filho de ProjectedFields). Observação: na versão de visualização de tecnologia de Microsoft SharePoint Foundation 2010, o atributo Type tem um significado diferente e apenas um valor possível ("Pesquisa") quando ele é filho de ProjectedFields. Para obter mais informações sobre esse uso do Tipo, consulte Elemento ProjectedFields (Exibição). O SharePoint Foundation inclui os seguintes tipos de dados por padrão: AllDayEvent: especifica um evento durante todo o dia. Corresponde ao tipo de dados SQL de bit . Anexos: armazena as URLs para anexos. Corresponde ao tipo de dados SQL de bit . Boolean: usado para armazenar um valor TRUE/FALSE (armazenado no banco de dados como 0 ou 1). Esse campo é classificável e agrupado. Corresponde ao tipo de dados SQL bit e representado pela classe SPFieldBoolean . Calculado: especifica um campo cujo valor é calculado com base em outras colunas. Corresponde ao tipo de dados SQL sql_variant e representado pela classe SPFieldCalculated. Escolha: permite que o usuário especifique um conjunto predeterminado de valores que pode ser usado para inserir dados no campo. Os tipos Escolha e Pesquisa são os campos mais importantes para classificação e agrupamento. Os atributos BaseType e Format podem ser usados para campos de escolha. Esse campo é classificável e agrupado. Quando um valor é dado para uma opção de escolha, esse valor é usado como o valor enviado para a seleção de campo. Quando nenhum valor é dado, essa escolha é enviada como o valor de texto da escolha. Em todos os casos, o valor de texto da escolha é o que é exibido na interface do usuário (lista suspensa ou texto do botão de rádio). A ordem na qual as opções aparecem na interface do usuário de edição é sempre a ordem que os itens são especificados no elemento CHOICES . Use o tipo MultiChoice para especificar um campo Choice que implementa caixas de seleção e permite que o usuário selecione vários valores. Corresponde ao tipo de dados SQL nvarchar e representou a classe SPFieldChoice . Computado: especifica um campo que depende de outro campo para seu conteúdo. Por exemplo, um campo LinkTitleNoMenu equivale a cercar um valor de campo Title com um hiperlink. Representada pela classe SPFieldComputed . ContentTypeId: contém uma ID do tipo de conteúdo. Para obter informações sobre o formato de IDs do tipo de conteúdo, consulte IDs do tipo de conteúdo. Corresponde ao tipo de dados SQL varbinary . Contador: geralmente usado apenas para o campo ID interno. Seu valor inteiro é definido automaticamente como exclusivo em relação a todos os outros itens da lista atual. O tipo Contador é sempre somente leitura e não pode ser definido por meio de uma postagem de formulário. Esse campo é classificável, mas não agrupado. Corresponde ao tipo de dados SQL int . CrossProjectLink: usado para conectar um evento em uma lista do SharePoint com um site do Workspace de Reunião; refere-se especificamente ao tipo de campo da caixa de seleção usada nos formulários Novo e Editar Item para criar um site do Espaço de Trabalho de Reunião para o item. Corresponde ao tipo de dados SQL de bit e representado pela classe SPFieldCrossProjectLink . Conversor de Moedas: permite que um valor de moeda seja inserido. Cada campo de moeda está vinculado à moeda de uma localidade específica. Em todos os outros aspectos, ele é tratado como o tipo de campo Número . Use o atributo LCID para indicar uma moeda de uma localidade específica. Os atributos Decimals, Max e Min podem ser usados para tipos de moeda. Esse campo é classificável e agrupado. Corresponde ao tipo de dados SQL flutuante e representado pela classe SPFieldCurrency . DateTime: permite o armazenamento de uma data ou hora do dia totalmente qualificada. Use o atributo Format para especificar a formatação de data e use o atributo StorageTZ para determinar como os valores de data/hora são armazenados. Esse campo é classificável e agrupado. Para modo de exibição, a ordem de formatação de data deriva das configurações regionais ("M/D/Y" ou "D/M/Y"). No modo Editar (ou no novo modo para o valor do elemento Padrão ), data/hora são renderizadas em formato universal: M/D/Y hh:mm am/pm. Corresponde ao tipo de dados SQL datetime e representou a classe SPFieldDateTime . Arquivo: contém um arquivo. Corresponde ao tipo de dados SQL do uniqueidentifier . GridChoice: contém uma escala de classificação para pesquisas. Corresponde ao tipo de dados SQL ntext e representado pela classe SPFieldRatingScale . Guid: permite guids (identificadores globalmente exclusivos). Corresponde ao tipo de dados SQL do uniqueidentifier . Inteiro: permite valores inteiros positivos ou negativos. Os atributos Commas e NegativeFormat são usados para especificar a formatação de inteiros. Corresponde ao tipo de dados SQL int . Pesquisa: comporta-se de forma muito semelhante a um campo Choice , exceto que as opções disponíveis vêm de outra lista, em vez de ser uma seleção codificada de valores. Os atributos List e ShowField podem ser usados para campos de pesquisa. Esse campo é classificável e agrupado. Para classificação e agrupamento, use o valor DisplayField (Título, por padrão) em vez da chave estrangeira armazenada na lista. Corresponde ao tipo de dados SQL int e representado pela classe SPFieldLookup . LookupMulti: um campo de pesquisa que pode conter mais de um valor. Tipo pai: pesquisa. ModStat: contém o status de aprovação de conteúdo. Os valores possíveis incluem Aprovado (padrão), Rejeitado e Pendente (armazenados no banco de dados como 0, 1 ou 2, respectivamente). Corresponde ao tipo de dados SQL int . MultiChoice: especifica um campo Choice que implementa caixas de seleção e permite que o usuário selecione vários valores. Corresponde ao tipo de dados SQL ntext e representado pela classe SPFieldMultiChoice . MultiColumn: um campo de observação que emula um campo que contém vários valores. Para obter um exemplo de um tipo de campo multicolumn, consulte Definição de tipo de campo personalizado. Para obter informações sobre campos multicolumn, consulte Classes de campo multicolumn personalizadas. Tipo pai: Observação. Observação: permite que os usuários insiram várias linhas de texto. Esse campo não é classificável ou agrupado. Todo o texto é definido como caracteres ASCII diretos sem marcação HTML. Qualquer coisa que se pareça com marcação HTML ou uma URL é simplesmente citada (por exemplo, Server.HTMLEncode) para parecer um texto direto. O controle para edição desse formato é um bloco TEXTAREA simples. Use o atributo NumLines para especificar o número de linhas a serem exibidas. Corresponde ao tipo de dados SQL ntext e representado pela classe SPFieldMultiLineText . Número: permite que um número de ponto flutuante seja inserido. Esse campo é classificável e agrupado. Os números inseridos são analisados de acordo com as configurações de localidade atuais para pontos decimais e mil separadores. Números negativos podem ser indicados envolvendo-os em parênteses ou usando um símbolo negativo. Os atributos a seguir podem ser usados em conjunto com o atributo Número para especificar a formatação de números: Decimals, Div, Max, Min, Mult e Percentage. Corresponde ao tipo de dados SQL flutuante e representado pela classe SPFieldNumber . PageSeparator: insere uma quebra de página em uma lista de pesquisas. Representada pela classe SPFieldPageSeparator . Recorrência: usado para editar e definir o padrão de recorrência para um item em uma lista de eventos. Corresponde ao tipo de dados SQL de bit . Texto: uma única linha de texto inserida em uma caixa de edição. Esse campo é classificável e agrupado. Use o atributo MaxLength para definir um número máximo de caracteres permitido. Corresponde ao tipo de dados SQL nvarchar e representado pela classe SPFieldText . ThreadIndex: contém a ID que indica a posição relativa de uma mensagem dentro de um thread de conversa. Corresponde ao tipo de dados SQL varbinary . Threading: o tipo de campo Threading é usado na criação e exibição de exibições semelhantes a discussões em thread. Qualquer lista pode conter uma coluna de threading, mas uma interface do usuário especial é gerada quando ela é usada. (Ele nunca é exibido como um campo editável padrão em um formulário nem como uma coluna normal em um modo de exibição.) Se uma classificação for executada em um campo de threading, uma travessia de pré-ordem de todos os registros em uma relação pai-filho será retornada. Isso é feito salvando a concatenação da data de criação e do número de ID de todos os registros pai de um registro específico. Corresponde ao tipo de dados SQL varchar . URL: usado para criar um hiperlink de forma livre. Um campo de URL é exibido como Descrição. Se nenhuma descrição for dada, ela será exibida como URL. O texto da URL é armazenado na tabela URLs (DocMd), que armazena todas as URLs nos bancos de dados do SharePoint no servidor. Isso é feito para que todas as URLs locais no servidor possam ser atualizadas por meio da correção de link quando o destino for movido. Quando um registro com um campo de URL contido nele é excluído, o registro referenciado correspondente da tabela URL também é excluído. Esse campo é classificável e agrupado. (O tipo é definido de acordo com a descrição textual em vez do conteúdo da URL; se nenhuma descrição for dada, ela classifica o mesmo que em branco.) Quando Type é URL, o atributo LinkType pode ser usado para especificar o tipo de link. Corresponde ao tipo de dados SQL nvarchar e representado pela classe SPFieldUrl . Usuário: um campo Pesquisa que faz referência à tabela de banco de dados UserInfo. Corresponde ao tipo de dados SQL int e representado pela classe SPFieldUser . UserMulti: um campo de usuário que pode conter mais de um valor. Tipo pai: LookupMulti. WorkflowEventType: especifica um tipo de evento de fluxo de trabalho representado pela enumeraçãoSPWorkflowHistoryEventType . Tipo pai: inteiro. WorkflowStatus: especifica o status do fluxo de trabalho representado pela enumeração SPWorkflowStatus . Corresponde ao tipo de dados SQL nvarchar** .
UniqueId	Texto opcional. Não se destina a ser usado diretamente do código.
UnlimitedLengthInDocumentLibrary	Booliano opcional. TRUE para permitir o comprimento de campo ilimitado em bibliotecas de documentos.
Urlencode	Booliano opcional. TRUE para converter caracteres especiais, como espaços, no formato UTF-8 citado, por exemplo, %c3%ab para o caractere ë.
URLEncodeAsURL	Booliano opcional. Como URLEncode, mas TRUE para especificar que a cadeia de caracteres a ser codificada é um componente de caminho de uma URL para que as barras de encaminhamento ("/") não sejam codificadas.
UserSelectionMode	Texto opcional. Especifica se apenas os nomes de usuários individuais podem ser selecionados em um campo de usuário em um formulário de item ou se os nomes de indivíduos e grupos podem ser selecionados. Os seguintes valores são possíveis: 0: somente os nomes de indivíduos podem ser selecionados. 1: os nomes de indivíduos e grupos podem ser selecionados.
UserSelectionScope	Inteiro opcional. Especifica um escopo para selecionar nomes de usuário em um campo de usuário em um formulário de item. Se o valor for 0, não haverá restrição a um grupo do SharePoint. Se o valor for maior que 0, a seleção de usuário será restrita a membros do grupo do SharePoint cuja ID é igual ao valor especificado.
Visível	Booliano opcional. TRUE para especificar que o campo é adicionado à exibição padrão. O valor padrão é TRUE.
Width	Inteiro opcional. Especifica a largura em pixels das imagens exibidas para usuários na lista Informações do Usuário.
WikiLinking	Booliano opcional. TRUE para especificar que os links wiki, que aparecem na forma de colchetes duplos ([[...]]), se convertem em links HTML, que usam a `<a>` marca.
Xname	Texto opcional. Usado internamente em formulários XML para identificar campos que foram adicionados, excluídos ou modificados. Esse atributo não se destina ao uso público.

Elementos filho

Elementos pai

Elementos

Comentários

Importante

Ao definir um campo personalizado, você deve especificar os atributos ID, Type, Name, DisplayName e Group para que o campo apareça corretamente no Microsoft SharePoint Foundation. A conclusão da instrução no Microsoft Visual Studio indica erroneamente que você precisa apenas dos três primeiros atributos quando, na verdade, todos os cinco são necessários.

Exemplo

O exemplo a seguir mostra um manifesto de elemento para um recurso que cria três colunas de site.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
          Name="Amount"
          DisplayName="Amount"
          Type="Currency"
          Decimals="2"
          Min="0"
          Required="FALSE"
          Group="Financial Columns" />

  <Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
          Name="CostCenter"
          DisplayName="Cost Center"
          Type="Choice"
          Required="FALSE"
          Group="Financial Columns">
    <CHOICES>
      <CHOICE>Administration</CHOICE>
      <CHOICE>Information</CHOICE>
      <CHOICE>Facilities</CHOICE>
      <CHOICE>Operations</CHOICE>
      <CHOICE>Sales</CHOICE>
      <CHOICE>Marketing</CHOICE>
    </CHOICES>
  </Field>

  <Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
          Name="DateOpened"
          DisplayName="Date Opened"
          Type="DateTime"
          Format="DateOnly"
          Required="FALSE"
          Group="Financial Columns">
    <Default>[today]</Default>
  </Field>
</Elements>

Compartilhar via