Campo de Processamento Controles

Um controle processamento classe pode ser usado, em conjunto com um modelo processamento, para processar seu personalizado campos no novo modo ou modo editar. (Tal pode classes também usado para processar um campo no modo de exibição, mas ele é mais comum para usar um RenderPattern definidos um campo definição para processar campos no modo de exibição.)

Um controle processamento classe deve herdar de BaseFieldControl ou uma das classes em Windows SharePoint Services que derivado dele. Essa classe é compilado para o mesmo assembly como o personalizado campo classe.

Recomendamos que você use o seguinte convenção de nomenclatura quando você cria personalizado que são classes campo derivado, diretamente ou indiretamente, a BaseFieldControl T:Microsoft.SharePoint.WebControls.BaseFieldControl classe:

field_type_name FieldControl

, --de exemplo, TargetDateFieldControl Ou RegularExpressionFieldControl . (The BaseFieldControl-derived classes that ship with Windows SharePoint Services 3.0 were created before this naming convention was determined and they follow the pattern field_type_name O campo Como a DateTimeField.)

Um objeto instanciar um controle processamento mantém, na sua propriedade Field P:Microsoft.SharePoint.WebControls.FieldMetadata.Field, uma referência a objeto Field que ele processa. O segundo mantém uma referência ao controle seu processamento no seu FieldRenderingControl P:Microsoft.SharePoint.SPField.FieldRenderingControl propriedade. Como essas referências recíproco sugerem, os dois objetos são parceiros. O SPField-derivado objeto controla a interação com o de conteúdo banco de dados, enquanto o BaseFieldControl-derivado controle processamento controla a interação com usuários e o processamento do campo no interface do usuário.

O modelo de processamento

Cada controle processamento tem at least um processamento modelo associado com ele. Um objeto RenderingTemplate T:Microsoft.SharePoint.WebControls.RenderingTemplate é definido como um elemento RenderingTemplate RenderingTemplate em um arquivo .ascx na pasta C:\program files\common files\microsoft shared\web server extensions\12\template\controltemplates. O modelo processamento está relacionado ao seu valor ID identificação no processamento TemplateName P:Microsoft.SharePoint.WebControls.TemplateBasedControl.TemplateName propriedade do objeto controle.

Observação

BaseFieldControl herda TemplateBasedControl, membros, que habilitá-lo para ser vinculada a múltiplo modelos processamento e para alternar entre elas com base no contexto de processamento.

Para obter mais informações sobre modelos processamento, consulte Campo de processamento de modelos.

O método CreateChildControls

Um controle processamento classe substitui o CreateChildControls método que ele herda de Control. Como o modelo processamento está fazendo a maioria do trabalho processamento, o CreateChildControls M:Microsoft.SharePoint.WebControls.BaseFieldControl.CreateChildControls método tem muito menos fazer que faria em uma classe controle clássico ASP.NET. Geralmente, ele fornece somente um toque final aos controles filho. De exemplo, ele pode atribuir um valor usar como padrão para um controle filho no novo modo ou atribuir atual do campo de valor para um controle filho no modo Editar. Não é provável que seu substituições de CreateChildControls conterá muita new operadores criando filho controles (que podem vir como uma surpresa se você tiver um segundo plano em programação ASP.NET).

Dados validação lógica, às vezes, está incluída no CreateChildControls. Para obter mais informações sobre personalizado campo validação de dados, consulte A validação de dados do campo personalizado.

Consulte também

Tarefas

Walkthrough: Criar um tipo de campo personalizado

Conceitos

Tipos de campo personalizado
Classes do campo personalizado
A validação de dados do campo personalizado
Definição Tipo de campo personalizado
Campo de processamento de modelos
Padrões de processamento do campo personalizado