Cómo: Crear cuadrículas de propiedades para la configuración del usuario en Visual Basic

  • Artículo

Actualización: noviembre 2007

Puede crear una cuadrícula de propiedades para la configuración del usuario rellenando un control PropertyGrid con las propiedades de configuración de usuario del objeto My.Settings.

Nota:

Para que este ejemplo funcione, su aplicación debe tener definida la configuración del usuario. Para obtener información sobre cómo agregar configuraciones de usuario, vea Cómo: Agregar o quitar valores de configuración de la aplicación.

El objeto My.Settings expone cada configuración como una propiedad. El nombre de propiedad es igual que el nombre de la configuración y el tipo de propiedad es igual que el tipo de configuración. El Ámbito de la configuración determina si la propiedad es de sólo lectura; la propiedad de una configuración de ámbito Aplicación es de sólo lectura, en tanto que la propiedad de una configuración de ámbito Usuario es de lectura y escritura. Para obtener más información, vea My.Settings (Objeto).

Nota:

No puede cambiar ni guardar en tiempo de ejecución los valores de configuración de ámbito de aplicación. La configuración de ámbito de aplicación sólo se puede cambiar al crear la aplicación (mediante el Diseñador de proyectos) o editando el archivo de configuración de la aplicación. Para obtener más información, vea Administrar la configuración de la aplicación.

Este ejemplo utiliza un control PropertyGrid para tener acceso a las propiedades de configuración del usuario del objeto My.Settings. De manera predeterminada, PropertyGrid muestra todas las propiedades del objeto My.Settings. Sin embargo, las propiedades de configuración del usuario tienen el atributo UserScopedSettingAttribute. Este ejemplo establece la propiedad BrowsableAttributes de PropertyGrid en UserScopedSettingAttribute para mostrar sólo las propiedades de configuración del usuario.

Para agregar una cuadrícula de propiedades de configuración de usuario

  1. Agregue el control PropertyGrid del Cuadro de herramientas a la superficie de diseño de la aplicación, que aquí será Form1.

    El nombre predeterminado del control de cuadrícula de propiedades es PropertyGrid1.

  2. Haga doble clic en la superficie de diseño de Form1 para abrir el código del controlador de eventos de carga del formulario.

  3. Establezca el objeto My.Settings como el objeto seleccionado para la cuadrícula de propiedades.

    PropertyGrid1.SelectedObject = My.Settings

  4. Configure la cuadrícula de propiedades para mostrar sólo la configuración del usuario.

    ' Attribute for the user-scope settings.
Dim userAttr As New System.Configuration.UserScopedSettingAttribute
Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
PropertyGrid1.BrowsableAttributes = attrs
    Nota:

    Para mostrar sólo la configuración de ámbito de aplicación, utilice el atributo ApplicationScopedSettingAttribute en lugar de UserScopedSettingAttribute.

Programación eficaz

La aplicación guarda la configuración del usuario cuando se cierra. Para guardar inmediatamente la configuración, llame al método My.Settings.Save. Para obtener más información, vea Cómo: Conservar la configuración del usuario en Visual Basic.

Vea también

Tareas

Cómo: Leer la configuración de la aplicación en Visual Basic

Cómo: Cambiar la configuración del usuario en Visual Basic

Cómo: Conservar la configuración del usuario en Visual Basic

Cómo: Agregar o quitar valores de configuración de la aplicación

Referencia

My.Settings (Objeto)

Otros recursos

Administrar la configuración de la aplicación