Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
Este tutorial muestra cómo agregar un atributo a un control de usuario en un proyecto de dispositivo. Más concretamente, se agrega un atributo personalizado que hace que una propiedad del control no pueda verse en tiempo de diseño. Puede que desee agregar esta característica a un proyecto para evitar que el valor de una propiedad cambie.
Este proceso es parecido al proceso del escritorio, con la salvedad de que los proyectos de dispositivos almacenan esta información en archivos de metadatos separados (.xmta).
.gif "Nota") Nota: |
|---|
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio. |
Este tutorial se ha escrito usando Configuración de desarrollo de Visual C#.
Para crear la clase UserControl1
En el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.
En el panel Tipos de proyecto, expanda Visual C#y, a continuación, haga clic en Smart Device.
En el panel Plantillas, haga clic en Proyecto de Smart Device.
En el cuadro Nombre, escriba MyControlLibrary y, a continuación, haga clic en Aceptar.
En el cuadro de diálogo Agregar nuevo proyecto de Smart Device, seleccione Pocket PC 2003 en el menú desplegable Plataforma de destino, seleccione .NET Compact Framework Versión 2.0 en el menú desplegable Versión de .NET Compact Framework, haga clic en Biblioteca de controles en el panel Plantillas y, a continuación, haga clic en Aceptar.
El diseñador se abre con un cuadro que representa la nueva clase de control de usuario.
Para agregar una propiedad
En el Explorador de soluciones, haga clic con el botón secundario del mouse en UserControl1.cs y, a continuación, haga clic en Ver diagrama de clase.
Se abre un rectángulo redondeado que representa el diagrama de clase.
Haga clic con el botón secundario en el diagrama de clase y, a continuación, haga clic en Detalles de clase.
En la sección Propiedades de la ventana Detalles de clase, en el símbolo del sistema <agregar propiedad>, escriba MyProperty.
En la columna Tipo, sustituya int por string.
Haga clic con el botón secundario del mouse en el icono que aparece al principio de la fila MyProperty y, a continuación, en el menú de acceso directo, haga clic en Propiedades.
Con el fin de especificar un valor para la propiedad Custom Attributes, haga clic en el botón de puntos suspensivos (…) y así abrir el cuadro de diálogo Atributos personalizados.
Escriba Browsable(false) y, a continuación, haga clic en Aceptar.
El Explorador de soluciones muestra un archivo de atributos en tiempo de diseño .xmta (DesignTimeAttributes.xmta) que contiene el atributo personalizado.
Para generar la biblioteca de controles
En el Explorador de soluciones, haga clic con el botón secundario del mouse en UserControl1.cs y, a continuación, haga clic en Ver diagrama de clase.
Marque como comentario la línea que produce la excepción System.NotImplementedException e inserte return ""; en lugar de la acción get.
En el menú Generar, haga clic en Generar MyControlLibrary.
Para comprobar que MyProperty no aparece en el explorador de propiedades
En el Explorador de soluciones, haga clic con el botón secundario del mouse en MyControlLibrary, seleccione Agregar y, a continuación, haga clic en Nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, haga clic en Windows Forms en el panel Categorías y haga clic en Formulario Windows Forms en el panel Plantillas y, a continuación, haga clic en Agregar.
Desde el Cuadro de herramientas, arrastre UserControl1 hasta el formulario.
Haga clic con el botón secundario en la imagen del control de usuario en el formulario y, a continuación, haga clic en Propiedades.
MyProperty no aparece en el explorador Propiedad.
En el Explorador de soluciones, haga doble clic en el archivo .xmta y, a continuación, reemplace false por true.
Repita los pasos para ver la cuadrícula Propiedades. Observe que, ahora, aparece MyProperty.