Definição Tipo de campo personalizado
Definição de tipo um campo é um arquivo XML nomeado nas fldtypes*.XML padrão que é implantado para o C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML. O campo tipos que enviar com Windows SharePoint Services 3.0 estão localizadas no arquivo de FLDTYPES.XML. Um arquivo definição campo contém as informações que Windows SharePoint Services precisa processar corretamente o campo, incluindo suas cabeçalho de coluna, em uma página exibição de lista (such as AllItems.aspx). Ele também geralmente fornece informações usadas para processar o campo na página de exibição lista item (such as DispForm.aspx). O nome e descrição do tipo de campo, como ele aparece na tais páginas interface do usuário como a [lista] página Personalizar, a nova coluna site e as páginas criar colunas, também é configurada no definição de tipo campo. Mais importante, a definição contém informações sobre o assembly que contém o compilado tipo de campo.
A maioria das propriedades tipo de campo são exigido pelo praticamente qualquer tipo de campo, such as as propriedades Nome e descrição. Mas um definição de tipo campo também pode declarar e definir propriedades especiais de tipo de campo que são relevantes apenas para colunas feitas de campos de que tipo específico. Esses são chamado variável propriedades tipo de campo . Os valores dessas propriedades são definidos sempre que uma coluna é criada com base na tipo de campo.
Em ordem para reconhecer um personalizado tipo de campo, Windows SharePoint Services 3.0 deve ter um definição de tipo campo em um arquivo fldtypes*.xml. Você cria esses arquivos na Microsoft Visual Studio como parte de um personalizado projeto tipo de campo. De exemplo, se você tivesse um definição de tipo campo para um tipo de campo que definido um número American Social Security, você poderá nomear as arquivo XML fldtypes_ssn_MyCompany.xml.
Observação
Recomendamos que você execute um padrão de nomeação sistemática e incluir o nome da empresa para que suas definições campo no ... \XML \XML Diretório pode ser distinto facilmente daqueles de outros provedores solução.É possível ter definição more than um campo no mesmo arquivo (as in o exemplo abaixo) e isso pode ser uma diretiva claro quando você tem vários tipos campo que você conhece sempre será implantada juntos.Mas para fins de simplicidade nas instruções, a Windows SharePoint Services 3.0 SDK geralmente pressupõe que haja apenas um personalizado tipo de campo em cada personalizado fldtypes*.xml.O FLDTYPES.XML que acompanha Windows SharePoint Services 3.0 tem várias definições tipo de campo.Modificar esse arquivo éNão com suporte.
A seguinte é uma lista dos elementos incluídos definição de tipo o campo. Clique no nome do elemento para informações detalhadas sobre esse elemento.
O parte superior nível elemento contêiner para o arquivo fldtypes*.xml. |
|
O parte superior nível elemento contêiner para definição de tipo um campo. |
|
Um elemento que representa uma única característica da tipo de campo. |
|
Um elemento que define variável propriedades tipo de campo . |
|
O de alto nível contêiner elemento em um elemento PropertySchema PropertySchema. |
|
Um elemento que representa uma variável propriedade de um personalizado que é definido quando uma coluna baseia a tipo de campo tipo de campo é criado. |
|
Um elemento que representa o valor de uma propriedade de um personalizado usar como padrão tipo de campo. |
|
Um elemento que define como o campo é processado na determinadas circunstâncias. |
Exemplo de definição tipos de campos
O seguinte exemplo define dois personalizado tipos campo.
<?xml version="1.0" encoding="utf-8" ?>
<FieldTypes>
<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.SSNField, AdventureWorks.FieldTypes,
Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
</Field>
<RenderPattern name="DisplayPattern">
<Column HTMLEncode="TRUE" />
<Column HTMLEncode="TRUE" UseRelatedField="TRUE"/>
</RenderPattern>
</FieldType>
<FieldType>
<Field name="TypeName">USAddress</Field>
<Field name="ParentType">MultiColumn</Field>
<Field name="TypeDisplayName">US Address</Field>
<Field name="TypeShortDescription">US Address(12345 NE 123 St. Redmond, WA 98052)
</Field>
<Field name="UserCreatable">TRUE</Field>
<Field name="FieldTypeClass">
AdventureWorks.FieldTypes.USAddressField, AdventureWorks.FieldTypes,
Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
</Field>
<PropertySchema>
<Fields>
<Field name="DefaultCity" Displayname="Default City"
MaxLength="50" DisplaySize="15" Type="Text">
<Default>Redmond</Default>
</Field>
<Field name="DefaultState" Displayname="Default State"
MaxLength="2" DisplaySize="2" Type="Text">
<Default>WA</Default>
</Field>
<Field name="DefaultZip" Displayname="Default Zip" MaxLength="5"
DisplaySize="5" Type="Text">
<Default>98052</Default>
</Field>
</Fields>
</PropertySchema>
<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[, ]]></HTML>
<Column SubColumnNumber="2" HTMLEncode="TRUE"/>
<HTML><![CDATA[ ]]></HTML>
<Column SubColumnNumber="3" HTMLEncode="TRUE"/>
</Default>
</Switch>
</RenderPattern>
</FieldType>
</FieldTypes>
Definições do campo tipo no modelo de objeto
Depois de implantar uma solução tipo de campo, você pode acessar o definição de tipo campo na modelo de objeto Windows SharePoint Services 3.0 wssversion3short como um objeto SPFieldTypeDefinition T:Microsoft.SharePoint.SPFieldTypeDefinition. A maioria das configurações de que você definir na XML definição de tipo de campo é representada como membros somente leitura o SPFieldTypeDefinition T:Microsoft.SharePoint.SPFieldTypeDefinition classe. A maioria das propriedades dessa classe têm o mesmo nome como o correspondente configuração no arquivo de fldtypes*.xml. Consulte Elemento de campo (tipos de campos) para obter detalhes sobre as exceções.
O elemento RenderPattern RenderPattern não é acessível através de SPFieldTypeDefinition. O elemento PropertySchema PropertySchema é legível no PropertySchema P:Microsoft.SharePoint.SPFieldTypeDefinition.PropertySchema propriedade como um seqüência de caracteres XML.
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