Tutorial de ASP.NET
Vista Previa de ASP.NET 2.0

Editando Propiedades de un Elemento Web

Una característica clave de los Elementos Web es la capacidad de los usuarios finales de modificar (o personalizar) las páginas web de acuerdo con sus preferencias y guardar sus ajustes personalizados para futuras sesiones en el navegador. Un aspecto de la modificación de páginas web incluye la edición; los usuarios pueden modificar la apariencia, diseño, comportamiento y otras propiedades de los Elementos Web visibles.

Este ejemplo muestra como editar propiedades de los Elementos Web

  1. Entrad en la página
  2. Seleccionad "Edit" en la lista desplegable
  3. Haced click en la flecha de la lista desplegable del Menú Verbo y seleccionad "Edit" en el menú. Ahora será visible el editor con una rejilla de propiedades mostrando la propiedad Text.
  4. Cambiad la propiedad "title" y pulsa OK. Un nuevo título debería aparecer en el control calendario.

C# Editando propiedades de Elementos Web

Los desarrolladores pueden beneficiarse del control MultiView para tener edición de una página completa.

Este ejemplo muestra como implementar un escenario de edición de página completa usando MultiView

  1. Entrad en la página
  2. Seleccionad "Edit" en la lista desplegable
  3. Haced click en la flecha de la lista desplegable del Menú Verbo y seleccionad "Edit" en el menú. Ahora será visible el editor con una rejilla de propiedades mostrando la propiedad Text.
  4. Cambiad la propiedad "title" y pulsa OK. Un nuevo título debería aparecer en el control calendario.
C# Editando página completa


Un control Elemento Web puede también especificar propiedades que pueden ser editadas por el usuario. Para dotarlo de propiedades editables se puede marcar la declaración de la propiedad con el atributo WebBrowsable. El EditorZone de la página debe también un EditorPart capaz de editar las propiedades personalizadas. Se puede usar el PropertyGridEditorPart para proporcionar edición en una tabla de propiedades.

Este ejemplo hace que la propiedad Text del Elemento Web sea editable y utiliza un PropertyGridEditorPart para permitir que los usuarios la modifiquen.

  1. Entrad en la página.
  2. Seleccionad "Edit" en la lista desplegable
  3. Haced click en la flecha de la lista desplegable del Menú Verbo y seleccionad "Edit" en el menú. Ahora será visible el editor con una rejilla de propiedades mostrando la propiedad Text. 
C# Haciendo WebBrowsable las propiedades web


Los desarrolladores pueden especificar un nombre "amigable" para las propiedades marcadas como WebBrowsable declarando el atributo WebDisplayName.

Este ejemplo marca la propiedad Text como WebDisplayName para mostrar un nombre "amigable" en el PropertyGridEditorPart. 

  1. Entrad en la página.
  2. Seleccionad "Edit" en la lista desplegable
  3. Haced click en la flecha de la lista desplegable del Menú Verbo y seleccionad "Edit" en el menú. Ahora será visible el editor con una rejilla de propiedades mostrando el nombre elegido.
C# Definiendo un nombre "amigable"

Los desarrolladores también pueden especificar un tooltip para propiedades marcadas como WebBrowsable  declarando el atributo WebDescription.

Ese ejemplo marca la propiedad Text como WebDescription para mostrar un tooltip en el PropertyGridEditorPart.

  1. Entrad en la página.
  2. Seleccionad "Edit" en la lista desplegable
  3. Haced click en la flecha de la lista desplegable del Menú Verbo y seleccionad "Edit" en el menú. Ahora será visible el editor con una rejilla de propiedades mostrando el nombre elegido
C# añadiendo una descripción de la propiedad.

Podemos además proporcionar nuestros propios EditorPart personalizados para modificar las propiedades del Elemento Web. Estos EditorPart se muestran en la zona de edición cuando el usuario edita el Elemento Web.

Para crear un EditorPart personalizado heredamos del control EditorWebPart. El control EditorWebPart es un control compuesto por lo que se puede sobreescribir el método CreateChildControls y crear controles para el elemento. Es necesario sobreescribir también los métodos ApplyChanges y SyncChanges para que los cambios hechos en el editor se apliquen al control.

Para proporcionar EditorParts personalizados se debe implementar la interface IWebEditable en el elemento e implementar el método CreateEditorParts y la propiedad WebBrowsableObject. El método CreateEditorParts debería devolver una colección de EditorParts.

Este ejemplo muestra un EditorPart personalizado.

  1. Entrad en la página.
  2. Seleccionad "Edit" en la lista desplegable
  3. Haz click en la flecha de la lista desplegable del Menú Verbo y selecciona "Edit" en el menú. Ahora será visible el editor con el EditorPart personalizado.
C# creando EditorPart personalizados