Cómo: Obtener acceso a los valores de configuración de usuario con servicios de aplicaciones cliente

Artículo
08/10/2011

Puede utilizar servicios de aplicaciones cliente para recuperar la configuración de aplicaciones de usuario de un servicio de perfil de Microsoft Ajax existente. La característica de configuración web de los servicios de aplicaciones cliente se integra con la característica de configuración de aplicaciones que ofrece .NET Framework 2.0. Para obtener más información sobre la configuración de aplicaciones, vea Introducción a la configuración de la aplicación. Para obtener información sobre cómo configurar el servicio de perfil de Microsoft Ajax, vea Utilizar información de perfiles con Microsoft Ajax.

El siguiente procedimiento describe cómo tener acceso a la configuración web cuando la aplicación está configurada para utilizar el servicio de configuración web. Para obtener más información, vea Cómo: Configurar servicios de aplicaciones cliente. Este procedimiento requiere acceso a un servicio de perfil de Microsoft Ajax en ejecución. Para obtener orientación sobre pruebas de un extremo a otro de las características de los servicios de aplicaciones cliente, vea Tutorial: Usar servicios de aplicaciones cliente.

Para tener acceso a la configuración web en la aplicación cliente de Windows

Asegúrese de que la aplicación está configurada correctamente para utilizar servicios de aplicaciones cliente, tal como se describe en Cómo: Configurar servicios de aplicaciones cliente. Como mínimo, debe especificar la ubicación de un servicio de configuración web en la página Servicios del diseñador de proyectos. Para recuperar la configuración web establecida para que la utilicen los usuarios autenticados, también deberá especificar una ubicación de servicio de autenticación o usar la autenticación de Windows.
En la página Configuración del diseñador de proyectos, haga clic en Cargar configuración web.

Aparecerá un cuadro de diálogo Inicio de sesión.
Para recuperar la configuración establecida en el servidor para que la utilicen todos los usuarios autenticados, especifique credenciales de usuario válidas y haga clic en Iniciar sesión. Para recuperar la configuración establecida para que la usen todos los usuarios anónimos, haga clic en Omitir inicio de sesión.

La configuración establecida en el servidor aparecerá en el diseñador. Además, una clase Settings (a la que se obtiene acceso como Properties.Settings.Default en C# y My.Settings en Visual Basic) se genera o actualiza para incluir las propiedades basadas en la configuración. Esta clase administra todas las interacciones con el servicio de configuración web remoto a través de la clase ClientSettingsProvider. Aunque puede tener acceso directo a la clase ClientSettingsProvider, normalmente tendrá acceso a ella indirectamente a través de la clase Settings, tal como se muestra en el paso siguiente. Para obtener más información, vea Información general sobre los servicios de aplicaciones cliente.

Nota

No puede utilizar la página Configuración para modificar los valores web predeterminados ni tener acceso a los valores no predeterminados. Además, si los valores predeterminados se modifican en el servidor, deberá recuperar los nuevos valores predeterminados haciendo clic en el botón Cargar configuración web. Los servicios de aplicaciones cliente no utilizan el botón Sincronizar.
En el código de aplicación, utilice propiedades de la clase generada para obtener o establecer los valores de configuración web.

El ejemplo de código siguiente supone que ha recuperado un valor de configuración denominado MySetting y que la aplicación contiene una etiqueta Label denominada myLabel.
```
My.Settings.MySetting = "test"
myLabel.Text = My.Settings.MySetting
```
```
Properties.Settings.Default.MySetting = "test";
myLabel.Text = Properties.Settings.Default.MySetting;
```
En el código de aplicación, utilice el método ApplicationSettingsBase.Save para guardar de nuevo los valores de configuración modificados en el servicio de configuración web.
```
My.Settings.Save()
```
```
Properties.Settings.Default.Save();
```

Programación eficaz

El código de ejemplo de este tema muestra el uso más simple de la configuración web en una aplicación cliente de Windows. Sin embargo, al guardar u obtener acceso a la configuración web a través de los servicios de aplicaciones cliente, el código puede iniciar una excepción WebException. Esto indica que el servicio no está disponible o que el inicio de sesión de usuario ha expirado. Para obtener un ejemplo de cómo administrar una excepción WebException en estos casos, vea Tutorial: Usar servicios de aplicaciones cliente.

Vea también

Cómo: Obtener acceso a los valores de configuración de usuario con servicios de aplicaciones cliente

Para tener acceso a la configuración web en la aplicación cliente de Windows

Programación eficaz

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales