方法 : クライアントアプリケーションサービスでユーザー設定にアクセスする

[アーティクル]
08/09/2011

クライアントアプリケーションサービスを使用して、既存の Microsoft Ajax プロファイルサービスからユーザーアプリケーション設定を取得できます。クライアントアプリケーションサービスの Web 設定機能は、.NET Framework 2.0 のアプリケーション設定機能に統合されています。アプリケーション設定の詳細については、「アプリケーション設定の概要」を参照してください。 Microsoft Ajax プロファイルサービスの設定方法の詳細については、「Microsoft Ajax でのプロファイル情報の使用」を参照してください。

Web 設定サービスを使用するようにアプリケーションが構成されている場合に Web 設定にアクセスする方法を、次の手順で説明します。詳細については、「方法 : クライアントアプリケーションサービスを構成する」を参照してください。この手順では、実行中の Microsoft Ajax プロファイルサービスへのアクセスが必要です。クライアントアプリケーションサービス機能の全体的なテストのガイダンスについては、「チュートリアル : クライアントアプリケーションサービスの使用」を参照してください。

Windows クライアントアプリケーションで Web 設定にアクセスするには

「方法 : クライアントアプリケーションサービスを構成する」に示すように、アプリケーションがクライアントアプリケーションサービスを使用するように適切に構成されていることを確認します。少なくとも、プロジェクトデザイナーの [サービス] ページで、Web 設定サービスの場所を指定しておく必要があります。認証済みユーザーによって使用されるように構成されている Web 設定を取得するには、認証サービスの場所を指定するか、Windows 認証を使用するように指定しておくことも必要です。
プロジェクトデザイナーの [設定] ページで、[Web 設定の読み込み] をクリックします。

[ログイン] ダイアログボックスが表示されます。
すべての認証済みユーザーによって使用されるようにサーバー上で構成されている設定を取得するには、有効なユーザーの資格情報を指定して、[ログイン] をクリックします。すべての匿名ユーザーによって使用されるように構成される設定を取得するには、[ログインのスキップ] をクリックします。

サーバー上で構成されている設定がデザイナー上に表示されます。さらに、設定に基づいたプロパティが含まれる Settings クラス (C# では Properties.Settings.Default、Visual Basic では My.Settings としてアクセスされる) が生成または更新されます。このクラスは、ClientSettingsProvider クラスを介してリモート Web 設定サービスとの全対話を管理します。 ClientSettingsProvider クラスには直接アクセスできますが、通常は、次の手順で説明するように、Settings クラスを介して間接的にアクセスします。詳細については、「クライアントアプリケーションサービスの概要」を参照してください。

注意

[設定] ページを使用して、既定の Web 設定値を変更したり、既定以外の値にアクセスしたりすることはできません。また、既定値がサーバー上で変更された場合には、[Web 設定の読み込み] ボタンをクリックして、新しい既定値を取得する必要があります。 [同期] ボタンは、クライアントアプリケーションサービスでは使用されません。
アプリケーションコードで、生成されたクラスのプロパティを使用して、Web 設定値を取得または設定します。

次のコード例では、MySetting という名前の設定が取得され、アプリケーションに myLabel という名前の Label が含まれていることを前提とします。
```
My.Settings.MySetting = "test"
myLabel.Text = My.Settings.MySetting
```
```
Properties.Settings.Default.MySetting = "test";
myLabel.Text = Properties.Settings.Default.MySetting;
```
アプリケーションコードで、ApplicationSettingsBase.Save メソッドを使用して、変更した設定値を Web 設定サービスに保存します。
```
My.Settings.Save()
```
```
Properties.Settings.Default.Save();
```

信頼性の高いプログラミング

このトピックでは、Windows クライアントアプリケーションで最も単純な Web 設定を使用するコード例を示します。ただし、クライアントアプリケーションサービスを介して Web 設定にアクセスするか、または設定を保存するときに、WebException をスローすることもできます。これは、サービスが使用できないか、ユーザーのログインの期限が切れていることを示します。このような場合の WebException の処理方法の例については、「チュートリアル : クライアントアプリケーションサービスの使用」を参照してください。

参照

方法 : クライアント アプリケーション サービスでユーザー設定にアクセスする

Windows クライアント アプリケーションで Web 設定にアクセスするには

信頼性の高いプログラミング

参照

処理手順

参照

概念

その他の技術情報

その他のリソース

方法 : クライアントアプリケーションサービスでユーザー設定にアクセスする

Windows クライアントアプリケーションで Web 設定にアクセスするには