方法 : クライアント アプリケーション サービスでユーザー設定にアクセスする
クライアント アプリケーション サービスを使用して、既存の 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.MySettingProperties.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 の処理方法の例については、「チュートリアル : クライアント アプリケーション サービスの使用」を参照してください。
参照
処理手順
方法 : クライアント アプリケーション サービスを構成する
チュートリアル : クライアント アプリケーション サービスの使用