次の方法で共有

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

  • [アーティクル]

更新 : 2007 年 11 月

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

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

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

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

  2. プロジェクト デザイナの [設定] ページで、[Web 設定の読み込み] をクリックします。

    [ログイン] ダイアログ ボックスが表示されます。

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

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

    メモ :

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

  4. アプリケーション コードで、生成されたクラスのプロパティを使用して、Web 設定値を取得または設定します。

    次のコード例では、MySetting という名前の設定が取得され、アプリケーションに myLabel という名前の Label が含まれていることを前提とします。

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

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

  5. アプリケーション コードで、ApplicationSettingsBase.Save メソッドを使用して、変更した設定値を Web 設定サービスに保存します。

    My.Settings.Save()

    Properties.Settings.Default.Save();

堅牢性の高いプログラム

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

参照

処理手順

方法 : クライアント アプリケーション サービスを構成する

チュートリアル : クライアント アプリケーション サービスの使用

方法 : アプリケーション設定を作成する

概念

クライアント アプリケーション サービスの概要

ASP.NET AJAX でのプロファイル情報の使用

アプリケーション設定の概要

参照

ClientSettingsProvider

ApplicationSettingsBase

ApplicationSettingsBase.Save

その他の技術情報

クライアント アプリケーション サービス

アプリケーションの設定の管理