Elemento de campo (tipos de campos)

Artigo
11/27/2008

Representa uma característica da tipo de campo.

                    
                      
<Field
  name="Text">
</Field>

Atributos

Atributo	Descrição
Name	Necessário Text. Um seqüência de caracteres que representa o nome do aspecto específico de tipo de campo que representa o Field do campo. O valor deve ser uma das seqüências de caracteres listadas na tabela a seguir.

Elementos filho

Nenhum

Elementos pai

Elemento FieldType (tipos de campos)

Comentários

Filhos elemento de campo de elementos FieldType FieldType são configurados em fldtypes*.xml arquivos C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML.

Cada elemento FieldType FieldType tem vários exigido e opcional campo Field elementos distintos por seu atributo Name Nome. A seguinte tabela descreve esses elementos. Em modelo de objeto o Windows SharePoint Services 3.0 wssversion3, um tipo de campo é representado pelo SPFieldTypeDefinition T:Microsoft.SharePoint.SPFieldTypeDefinition classe. A classe última possui um correspondente READ-ONLY propriedade para todos, mas duas das linhas da tabela. (As exceções são InternalType e SQLType). Exceto onde observado caso contrário, os nomes propriedade coincidem com o valor da correspondente atributo name.

Valor do atributo name do elemento de campo	Descrição
AllowBaseTypeRendering	Opcional Boolean. O usar como padrão é FALSE. Representa se um aplicativo cliente processa o campo como seu tipo base (também chamado de ParentType), se o aplicativo cliente não pode determinar como processar corretamente o personalizado tipo de campo. Se definido para TRUE e o aplicativo cliente não é possível corretamente processar o personalizado tipo de campo, o aplicativo cliente processa o campo como a tipo de campo pai Windows SharePoint Services wssnoversshort da qual ela herda.
FieldTypeClass	Opcional String, Mas exigido para todas as sua personalizado tipos campo . Representa a nome forte de biblioteca de classes de tipo de campo. " FieldTypeClass " includes the class name and assembly name with Version, Culture, and PublicKeyToken, for example, <Field name="FieldTypeClass">CustomFieldTypes.RegularExpression.RegularExpressionField, CustomFieldTypes.RegularExpression, Version=1.0.0.0, Culture=neutral, PublicKeyToken=57e55365ec0ce80a</Field> (Only the fully qualified class name is included for field types built into Windows SharePoint Services 3.0.)
FieldEditorUserControl	Opcional String. Representa o caminho relativo para um field_type Arquivo FieldEditor.ascx que define um controle que aparece, em Windows SharePoint Services 3.0, no Additional Column Settings seção sobre a página New Site Column. O controle permite que criadores coluna definir, de uma coluna específica, a variável Propriedades da tipo de campo. Ex.: `"/_controltemplates/RegularExpressionFieldEditor.ascx"`. If there is no <Field name="FieldEditorUserControl"> element, then the special properties of the field type are rendered by the Elemento PropertySchema (tipos de campos) element. FieldEditorUserControl deve ser um fixo, seqüência de caracteres nonlocalizable.
Filterable	Necessário Boolean. Representa se uma lista com uma coluna que baseia-se neste tipo de campo pode ser filtrada de acordo com o valor da coluna que usa esse tipo. Se definido como TRUE, o cabeçalho da coluna é um controle que os usuários podem usar para a lista filtro.
InternalType	Opcional String. Representa um tipo base interno. Não use um <Field name="InternalType"> elemento no seu personalizado definições tipo de campo.
ParentType	String necessárias (mas pode ser uma seqüência vazia). Representa o nome da partir da qual a classe campo é o tipo derivado. Os valores possíveis são exatamente o mesmo que os valores possíveis para o atributo Type Tipo do Elemento de campo (lista - de definição) elemento. Se não for o tipo de campo derivado do outro tipo, em seguida, o valor é um seqüência vazia: <Field name="ParentType"></Field>. Ele nunca deve ser vazio na sua personalizado tipos campo. Personalizado todos os tipos herdam de outro tipo. O objeto Windows SharePoint Services 3.0 wssversion3short modelo ParentType é chamado BaseRenderingTypeName.
ShowOnListAuthoringPages	Opcional Boolean. O usar como padrão é TRUE. Indica se este tipo de campo é exibido para inclusão em listas. Se definido como TRUE, wssnoversshort Windows SharePoint Services exibe este tipo de campo na lista criando páginas para que os usuários podem incluí o tipo de campo em suas listas. O objeto Windows SharePoint Services 3.0 wssversion3short modelo ShowOnListAuthoringPages é chamado ShowOnListCreate.
ShowOnDocumentLibraryAuthoringPages	Opcional Boolean. O usar como padrão é TRUE. Indica se este tipo de campo é exibido para inclusão no documento bibliotecas. Se definido como TRUE, wssnoversshort Windows SharePoint Services exibe este tipo de campo no documento biblioteca criando páginas para que os usuários podem incluí o tipo de campo em suas bibliotecas documento. O objeto Windows SharePoint Services 3.0 wssversion3short modelo ShowOnDocumentLibraryAuthoringPages é chamado ShowOnDocumentLibraryCreate.
ShowOnSurveyAuthoringPages	Opcional Boolean. O usar como padrão é TRUE. Indica se este tipo de campo é exibido para inclusão em pesquisas. Se definido como TRUE, wssnoversshort Windows SharePoint Services exibe este tipo de campo na pesquisa criando páginas para que os usuários podem incluí o tipo de campo em suas pesquisas. O objeto Windows SharePoint Services 3.0 wssversion3short modelo ShowOnSurveyAuthoringPages é chamado ShowOnSurveyCreate.
ShowOnColumnTemplateAuthoringPages	Opcional Boolean. O usar como padrão é TRUE. Indica se este tipo de campo deve ser exibido como uma coluna modelo tipo de campo. Se definido como TRUE, wssnoversshort Windows SharePoint Services exibe este tipo de campo na coluna modelo criando páginas para que os usuários podem selecionar para criar um modelo coluna deste tipo de campo. O objeto Windows SharePoint Services 3.0 wssversion3short modelo ShowOnColumnTemplateAuthoringPages é chamado ShowOnColumnTemplateCreate.
SQLType	Opcional String. Representa o tipo de dados SQL que serão usados para armazenar os dados no de conteúdo banco de dados. Não use um <Field name="SQLType"> elemento no seu personalizado definições tipo de campo.
Sortable	Necessário Boolean. Representa se uma lista com uma coluna que baseia-se neste tipo de campo pode ser classificada na coluna que usa esse tipo. Se definido como TRUE, o cabeçalho da coluna é um controle que os usuários podem usar para classificar a lista.
TypeDisplayName	Necessário String. Representa o nome exibir do tipo de campo na interface de usuário (interface do usuário). Em Windows SharePoint Services 3.0, ele será exibido na coluna tipo sobre a página [lista] personalizar (listedit.aspx). Ele também é usado no local de " TypeShortDescription " se o último não estiver presente. " TypeDisplayName " deve ser um seqüência de caracteres localizável.
TypeName	Necessário String. Representa o nome da tipo de campo. Este valor deve ser exclusivo entre todos os nomes tipo de campo no farm servidor SharePoint. "TypeName" deve ser um fixo, seqüência de caracteres nonlocalizable.
TypeShortDescription	Opcional String. Representa a descrição curta de tipo de campo que é exibido no interface do usuário. In Windows SharePoint Services 3.0 it appears with a radio button in the Name and Type section of the New Site Column and Create Column pages and in the Type column of the Site Column Gallery. If there is no <Field name="TypeShortDescription"> element, then "TypeDisplayName" is used. " TypeShortDescription " deve ser um seqüência de caracteres localizável.
UserCreatable	Opcional Boolean. O usar como padrão é TRUE que permite aos usuários adicionar campos deste tipo de campo a listas. Definindo o valor FALSE seção nome e tipo das páginas Create Column e New Site Column FALSE.

Exemplo

O seguinte exemplo define um personalizado tipo de campo.

                      <FieldType>
    <Field name="TypeName">SocialSecurityNumber</Field>
    <Field name="ParentType">Text</Field>
    <Field name="TypeDisplayName">Social Security Number</Field>
    <Field name="TypeShortDescription">Social Security Number (123456789, 123-45-6789)</Field>
    <Field name="AllowBaseTypeRendering">TRUE</Field>
    <Field name="FieldTypeClass">
      AdventureWorks.FieldTypes.SPFieldSSN, AdventureWorks.FieldTypes.SPFieldSSN,
      Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
    </Field>
    <RenderPattern name="DisplayPattern">
        <Column HTMLEncode="TRUE" /> 
        <Column HTMLEncode="TRUE" UseRelatedField="TRUE"/> 
    </RenderPattern>
  </FieldType>

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