Controles Editor para campos Tipo propriedades

  • Artigo

An editor control for the variable properties of a field type can be used, as an alternative to a Elemento PropertySchema (tipos de campos), to render the properties of the field on the New Site Column, Change Site Column, Create Column, and Change Column pages. Consulte Processamento da propriedade Tipo do campo personalizado para uma discussão sobre quando usar cada método e um visão geral das duas opções.

A criação de um controle do Editor

Um controle editor é definido em um arquivo .ascx em C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\ControlTemplates um code-behind file que são e compilado para o mesmo assembly como o personalizado campo classe. In addition to processamento as propriedades do campo, criadores coluna que oferece suporte a controle editor configuração essas propriedades com funções especiais, such as computacional complicado lógica, pesquisa de valores de dados fontes e personalizado validação de dados.

É recomendável que você nomear seu editor classes controle usando a seguinte observação convenção de nomenclatura:

field_type_name FieldEditor

de exemplo, TargetDateFieldEditor ou RegularExpressionFieldEditor. In line with esta convenção, o arquivo .ascx será nomeado field_type_name FieldEditor.ascx e será herdam a code-behind class field_type_name FieldEditor.

A interface IFieldEditor

Para trabalhar como um controle usuário editor campo, o code-behind class deve fazer o seguinte:

  • Herdam a classe UserControl T:System.Web.UI.UserControl, ou uma classe derivado dele.

  • Implemente a interface IFieldEditor T:Microsoft.SharePoint.WebControls.IFieldEditor.

A interface IFieldEditor T:Microsoft.SharePoint.WebControls.IFieldEditor inclui a seguinte propriedade e métodos. Clique no nome de cada para saber mais sobre como a implementá-lo.

  • DisplayAsNewSection   Use this property to specify whether or not you want the control to be displayed in the Additional Column Settings section on the New Site Column, Change Site Column, Create Column, and Change Column pages, or alone in a new section.

  • OnSaveChange usar esse método para validar e salvar as alterações feitas de um editor coluna - do criador ou coluna - às propriedades de campo (coluna).

  • InitializeWithField usar esse método para inicializar o controle editor com valores usar como padrão ou a atual propriedade valores de campo (coluna).

Consulte também

Conceitos

Tipos de campo personalizado
Classes do campo personalizado
Definição Tipo de campo personalizado