Руководство: доступ к параметрам пользователей с помощью служб клиентских приложений

Обновлен: Ноябрь 2007

Службы клиентских приложений позволяют извлекать пользовательские параметры приложений из существующей службы профилей ASP.NET AJAX. Функция веб-параметров служб приложений интегрируется с функцией параметров приложений в .NET Framework 2.0. Дополнительные сведения о параметрах приложений см. в разделе Общие сведения о параметрах приложений. Сведения о настройке службы профилей ASP.NET AJAX см. в разделе Использование сведений о профиле с ASP.NET AJAX.

В следующей процедуре описаны способы доступа к веб-параметрам, если приложение настроено на использование службы веб-параметров. Дополнительные сведения см. в разделе Практическое руководство. Настройка служб клиентских приложений. Для этой процедуры требуется доступ к действующей службе профилей ASP.NET AJAX. Советы по тестированию функций служб клиентских приложений см. в разделе Пошаговое руководство. Использование служб клиентских приложений.

Получение доступа к веб-параметрам в клиентском приложении Windows

1. Убедитесь, что приложение настроено правильно для использования служб клиентских приложений. Описание см. в разделе Практическое руководство. Настройка служб клиентских приложений. Как минимум, на странице Службы конструктора проектов следует указать расположение службы веб-параметров. Для извлечения веб-параметров, настроенных для прошедших проверку подлинности пользователей, необходимо указать расположение службы проверки подлинности или использовать проверку подлинности Windows.

2. На странице конструктора проектов Параметры щелкните Загрузить веб-параметры.

   Появится диалоговое окно Вход.

3. Чтобы извлечь параметры, настроенные на сервере для использования всеми прошедшими проверку подлинности пользователями, укажите допустимые учетные данные пользователя и нажмите Войти. Чтобы извлечь параметры, настроенные для всех анонимных пользователей, нажмите кнопку Пропустить вход.

   Параметры, настроенные на сервере, появятся в конструкторе. Кроме того, будет создан и обновлен класс Settings (доступный как Properties.Settings.Default в C# и My.Settings в Visual Basic) для включения свойств на основе параметров. Этот класс управляет взаимодействием с удаленной службой веб-параметров через класс ClientSettingsProvider. Можно получить прямой доступ к классу ClientSettingsProvider, но, как правило, применяется непрямой доступ через класс Settings, как показано в следующем шаге. Дополнительные сведения см. в разделе Общие сведения о службах клиентских приложений.

   Примечание.
   На странице Параметры нельзя изменить значения веб-параметров по умолчанию, равно как нельзя менять значения, не установленные по умолчанию. Кроме того, если значения по умолчанию изменить на сервере, новые значение по умолчанию потребуется получить, нажав кнопку Загрузить веб-параметры. Кнопка Синхронизировать не используется службами клиентских приложений.

4. Для получения значений веб-параметров, в коде приложения следует использовать свойства созданного класса.

   В следующем примере предполагается, что был получен параметр с именем MySetting и что приложение содержит Label с именем myLabel.

   My.Settings.MySetting = "test"
   myLabel.Text = My.Settings.MySetting
   

   Properties.Settings.Default.MySetting = "test";
   myLabel.Text = Properties.Settings.Default.MySetting;
   

5. Для сохранения измененных значений параметров в службе веб-параметров, в коде приложения используйте метод ApplicationSettingsBase.Save.

   My.Settings.Save()
   

   Properties.Settings.Default.Save();
   

Отказоустойчивость

В примере кода в этом разделе показано простейшее применение веб-параметров в клиентском приложении Windows. При доступе к веб-параметрам или их сохранении посредством служб клиентских приложений код может создать WebException. Это означает, что служба проверки недоступна или время входа пользователя истекло. Пример обработки этой ошибки WebException в таких случаях см. в разделе Пошаговое руководство. Использование служб клиентских приложений.

См. также

Задачи

Практическое руководство. Настройка служб клиентских приложений

Пошаговое руководство. Использование служб клиентских приложений

Практическое руководство. Создание параметров приложения

Основные понятия

Общие сведения о службах клиентских приложений

Использование сведений о профиле с ASP.NET AJAX

Общие сведения о параметрах приложений

Ссылки

ClientSettingsProvider

ApplicationSettingsBase

ApplicationSettingsBase.Save

Другие ресурсы

Службы клиентских приложений

Управление параметрами приложения