Compartir a través de

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

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

Nota:

Para que este ejemplo funcione, la aplicación debe tener configurada su configuración de usuario. Para obtener más información, consulte Administración de la configuración de la aplicación (.NET).

El My.Settings objeto expone cada valor como una propiedad. El nombre de la propiedad es el mismo que el nombre de la configuración y el tipo de propiedad es el mismo que el tipo de configuración. El ámbito de la configuración determina si la propiedad es de solo lectura; la propiedad de un valor de ámbito de aplicación es de solo lectura, mientras que la propiedad de un valor de ámbito de usuario es de lectura y escritura. Para obtener más información, vea Objeto My.Settings.

Nota:

No puede cambiar ni guardar los valores de la configuración del ámbito de aplicación en tiempo de ejecución. La configuración del ámbito de la aplicación solo se puede cambiar al crear la aplicación (a través del Diseñador de proyectos) o editando el archivo de configuración de la aplicación. Para obtener más información, consulte Administración de la configuración de la aplicación (.NET).

En este ejemplo se usa un PropertyGrid control para acceder a las propiedades de configuración de usuario del My.Settings objeto . De forma predeterminada, PropertyGrid muestra todas las propiedades del My.Settings objeto . Sin embargo, las propiedades de configuración de usuario tienen el UserScopedSettingAttribute atributo . En este ejemplo se establece la BrowsableAttributes propiedad de para PropertyGridUserScopedSettingAttribute mostrar solo las propiedades de configuración de 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 se supone que aquí es Form1.

    El nombre predeterminado del control property-grid es PropertyGrid1.

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

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

    PropertyGrid1.SelectedObject = My.Settings

  4. Configure la cuadrícula de propiedades para mostrar solo 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 solo la configuración del ámbito de la aplicación, use el ApplicationScopedSettingAttribute atributo en lugar de UserScopedSettingAttribute.

Programación sólida

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

Consulte también