Compartir a través de

Controles del editor para propiedades de tipo de campo

  • Artículo

Última modificación: miércoles, 30 de septiembre de 2009

Hace referencia a: SharePoint Foundation 2010

Se puede usar un control de editor para propiedades de variable de un tipo de campo como alternativa a un Elemento PropertySchema (Tipos de campo) para representar las propiedades del campo en las páginas Nueva columna de sitio, Cambiar columna de sitio, Crear columna y Cambiar columna. Consulte Representación de propiedades de tipo de campo personalizado para obtener una introducción a las dos opciones y una descripción de cuándo debe usarse cada método.

Creación de un control de editor

Un control de editor se define en un archivo .ascx en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates y en un archivo con código subyacente, que se compilan en el mismo ensamblado que la clase de campo personalizado. Además de representar las propiedades del campo, el control del editor proporciona a los autores de columnas que establecen estas propiedades algunas funciones especiales, como lógica computacional complicada, búsqueda de valores de orígenes de datos y validación de datos personalizados.

Nota   Se recomienda asignar un nombre a las clases del control de editor mediante la convención de nomenclatura siguiente:

nombreDeTipoDeCampoFieldEditor

, por ejemplo, TargetDateFieldEditor o RegularExpressionFieldEditor. Siguiendo esta convención, el archivo .ascx se denominará nombreDeTipoDeCampoFieldEditor.ascx y heredará de la clase de código subyacente nombreDeTipoDeCampoFieldEditor.

Interfaz IFieldEditor

Para actuar como un control de usuario del editor de campos, la clase de código subyacente debe hacer lo siguiente:

La interfaz IFieldEditor incluye la propiedad y los métodos siguientes. Haga clic en el nombre de cada uno de ellos para obtener más información sobre cómo implementarlos.

  • DisplayAsNewSection   Use esta propiedad para especificar si desea que el control se muestre en la sección de configuración adicional de columnasde las páginas Nueva columna de sitio, Cambiar columna de sitio, Crear columna y Cambiar columna, o bien de forma independiente en una nueva sección.

  • OnSaveChange   Use este método para validar y guardar los cambios del autor o del editor de una columna en las propiedades del campo (columna).

  • InitializeWithField   Use este método para inicializar el control de editor con los valores predeterminados o los valores de propiedad actuales del campo (columna).

Vea también

Conceptos

Tipos de campos personalizados

Procedimiento para crear una clase de campos personalizados

Procedimiento para crear una definición de tipo de campo personalizado