Gewusst wie: Zugreifen auf Benutzereinstellungen mit Clientanwendungsdiensten

Artikel
08/20/2008

Aktualisiert: November 2007

Sie können Clientanwendungsdienste verwenden, um Benutzeranwendungseinstellungen aus einem vorhandenen ASP.NET AJAX-Profildienst abzurufen. Das Webeinstellungsfeature der Clientanwendungsdienste wird mit dem in .NET Framework 2.0 bereitgestellten Feature für Anwendungseinstellungen integriert. Weitere Informationen über Anwendungseinstellungen finden Sie unter Übersicht über Anwendungseinstellungen. Weitere Informationen zum Einrichten des ASP.NET AJAX-Profildiensts finden Sie unter Verwenden von Profilinformationen mit ASP.NET-AJAX.

Im folgenden Verfahren wird beschrieben, wie auf Webeinstellungen zugegriffen wird, wenn die Anwendung für die Verwendung des Webeinstellungsdiensts konfiguriert ist. Weitere Informationen finden Sie unter Gewusst wie: Konfigurieren von Clientanwendungsdiensten. Dieses Verfahren setzt voraus, dass auf einen aktiven ASP.NET AJAX-Profildienst zugegriffen werden kann. Anweisungen zu End-to-End-Testverfahren für Clientanwendungsdienst-Features finden Sie unter Exemplarische Vorgehensweise: Verwenden von Clientanwendungsdiensten.

So greifen Sie auf Webeinstellungen in der Windows-Clientanwendung zu

Stellen Sie sicher, dass die Anwendung ordnungsgemäß für die Verwendung von Clientanwendungsdiensten konfiguriert ist, wie in Gewusst wie: Konfigurieren von Clientanwendungsdiensten beschrieben. Sie müssen auf der Seite Dienste des Projekt-Designers mindestens den Speicherort eines Webeinstellungsdiensts angeben. Um Webeinstellungen abzurufen, die zur Verwendung durch authentifizierte Benutzer konfiguriert sind, müssen Sie außerdem den Speicherort eines Authentifizierungsdiensts angeben oder die Windows-Authentifizierung verwenden.
Klicken Sie auf der Seite Einstellungen des Projekt-Designers auf Webeinstellungen laden.

Ein Dialogfeld Anmelden wird angezeigt.

Um Einstellungen abzurufen, die auf dem Server zur Verwendung durch alle authentifizierten Benutzer konfiguriert wurden, geben Sie gültige Benutzeranmeldeinformationen ein und klicken auf Anmelden. Um Einstellungen abzurufen, die zur Verwendung durch alle anonymen Benutzer konfiguriert wurden, klicken Sie auf Anmeldung überspringen.

Die auf dem Server konfigurierten Einstellungen werden im Designer angezeigt. Zusätzlich wird eine Settings-Klasse (auf die in C# als Properties.Settings.Default und in Visual Basic als My.Settings zugegriffen wird) generiert oder aktualisiert, um die auf den Einstellungen basierenden Eigenschaften zu berücksichtigen. Diese Klasse verwaltet über die ClientSettingsProvider-Klasse alle Interaktionen mit dem Remote-Webeinstellungsdienst. Obwohl der direkte Zugriff auf die ClientSettingsProvider-Klasse möglich ist, werden Sie normalerweise indirekt über die Settings-Klasse darauf zugreifen, wie im nächsten Schritt dargestellt. Weitere Informationen finden Sie unter Übersicht über Clientanwendungsdienste.

Hinweis:
Über die Seite Einstellungen können Sie weder die Standardwerte für Webeinstellungen ändern noch auf nicht standardmäßige Werte zugreifen. Wenn die Standardwerte auf dem Server geändert werden, müssen Sie zusätzlich die neuen Standardwerte abrufen, indem Sie auf die Schaltfläche Webeinstellungen laden klicken. Die Schaltfläche Synchronisieren wird von Clientanwendungsdiensten nicht verwendet.

Über die Seite Einstellungen können Sie weder die Standardwerte für Webeinstellungen ändern noch auf nicht standardmäßige Werte zugreifen. Wenn die Standardwerte auf dem Server geändert werden, müssen Sie zusätzlich die neuen Standardwerte abrufen, indem Sie auf die Schaltfläche Webeinstellungen laden klicken. Die Schaltfläche Synchronisieren wird von Clientanwendungsdiensten nicht verwendet.

Verwenden Sie im Anwendungscode Eigenschaften der generierten Klasse, um die Webeinstellungswerte abzurufen oder festzulegen.

Im folgenden Codebeispiel wird vorausgesetzt, dass Sie eine Einstellung mit dem Namen MySetting abgerufen haben und dass die Anwendung ein Label mit dem Namen myLabel enthält.
```
My.Settings.MySetting = "test"
myLabel.Text = My.Settings.MySetting
```
```
Properties.Settings.Default.MySetting = "test";
myLabel.Text = Properties.Settings.Default.MySetting;
```
Verwenden Sie im Anwendungscode die ApplicationSettingsBase.Save-Methode, um geänderte Einstellungswerte im Webeinstellungsdienst zu speichern.
```
My.Settings.Save()
```
```
Properties.Settings.Default.Save();
```

Robuste Programmierung

Durch den Beispielcode in diesem Thema werden die einfachsten Verwendungsmöglichkeiten der Webeinstellungen in einer Windows-Clientanwendung veranschaulicht. Wenn Sie über Clientanwendungsdienste auf Webeinstellungen zugreifen oder diese speichern, kann Ihr Code eine WebException auslösen. Dadurch wird angegeben, dass der Dienst nicht verfügbar oder die Benutzeranmeldung abgelaufen ist. Ein Beispiel zur Behandlung einer WebException in solchen Fällen finden Sie unter Exemplarische Vorgehensweise: Verwenden von Clientanwendungsdiensten.

Siehe auch

Freigeben über

Gewusst wie: Zugreifen auf Benutzereinstellungen mit Clientanwendungsdiensten

So greifen Sie auf Webeinstellungen in der Windows-Clientanwendung zu

Robuste Programmierung

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen