Campo de processamento de modelos

Um modelo processamento campo é um objeto que é definido como um elemento RenderingTemplate RenderingTemplate em um arquivo .ascx na pasta RenderingTemplateC:\program files\common files\microsoft shared\web server extensions\12\template\controltemplates. Ele é usado em conjunto com o CreateChildControls método M:Microsoft.SharePoint.WebControls.BaseFieldControl.CreateChildControls de um controle processamento classe para processar um campo no Novo ou Editar modos e às vezes, no modo de exibição.

Relação de processamento de modelos para processamento controles

Um objeto RenderingTemplate T:Microsoft.SharePoint.WebControls.RenderingTemplate é um tipo de híbrida Control-objeto ITemplate T:System.Web.UI.ITemplate. Ele deriva de Control e adiciona apenas um novo membro: um TemplateTemplateITemplate modelo que contém um objeto T:System.Web.UI.ITemplate. This makes it possible for a rendering control (derived from TemplateBasedControl) to reference ITemplate objects indirectly by referencing a RenderingTemplate object by the rendering template's ID property (ID). O controle processamento pode fazer isso usando uma ou mais das diversas propriedades String afirmativo, como TemplateName, que pode conter a identificação de um modelo processamento.

O sistema de modelo de processamento

Cada controle processamento campo tem at least um modelo processamento campo associado com ele. Ao processar-tempo, aparência Windows SharePoint Services 3.0 wssversion3 até o modelo necessário pesquisando as identificações de todos os controles declarados em arquivos .ascx em C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES (todas do qual carregar quando inicia o aplicativo da Web).

Campo de processamento de configuração

Você tem uma ampla variedade de opções para controle detalhada de como seu personalizado campos são processados usando campo processamento modelos. Este tópico descreve somente the most comum configuração. Para obter mais informações sobre outras opções processamento, consulte Padrões de processamento do campo personalizado.

O padrão do campo processamento configuração que você irá localizar mesmo usando com mais freqüência como você desenvolver personalizado tipos campo tem estas características:

• O controle processamento está associado com processamento apenas um modelo e o controle usa seus TemplateName propriedade para do especificar modelo ID.

• Este modelo um fornece a maioria do processamento campo nos modos novos e em Editar. (Processamento em Exibir modo mais comumente é tratado por um RenderPattern definidos um campo definição).

• CreateChildControls M:Microsoft.SharePoint.WebControls.BaseFieldControl.CreateChildControls método do controle processamento atribui valores usar como padrão a controles do controle de processamento filho no novo modo. Ele atribui do campo atual valores aos controles filho no modo Editar. (Ele faz nada no modo de exibição.) Ele também pode fazer outro trabalho processamento "toque final" such as atribuição uma classe folhas de estilo em cascata para um filho Label controle T:System.Web.UI.WebControls.Label.

• A validação lógica é implementada por Validate, IsValid e membros ErrorMessage P:Microsoft.SharePoint.WebControls.BaseFieldControl.ErrorMessage do controle processamento de campo e pela subjacente GetValidatedString método M:Microsoft.SharePoint.SPField.GetValidatedString(System.Object) do tipo de campo. ( Validate pode ser chamado por CreateChildControls.)

BaseFieldControl herda de TemplateBasedControl e de FieldMetadata 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 padrões adicionais de processamento campo, consulte Padrões de processamento 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
Classes do valor do campo personalizado
Definição Tipo de campo personalizado
Processamento da propriedade Tipo do campo personalizado
Controles Editor para campos Tipo propriedades
Campo de Processamento Controles
Padrões de processamento do campo personalizado