[設定] へのタブの追加
適用対象: Windows Server 2016 Essentials、Windows Server 2012 R2 Essentials、Windows Server 2012 Essentials
オペレーティング システムの設定マネージャーによって使用されるコード アセンブリを作成しインストールすることで、ダッシュボードの [設定] にタブを追加できます。
[設定] へのタブの追加
次のタスクを実行することで、[設定] にタブを追加します。
ISettingsData インターフェイスの実装のアセンブリへの追加
ISettingsData インターフェイスは、\Program Files\Windows Server\Bin にある AdminCommon.dll アセンブリの Microsoft.WindowsServerSolutions.Settings 名前空間に含まれています。
ISettingsData コードをアセンブリに追加するには
[スタート] メニューのプログラムを右クリックし、[管理者として実行] を選択して、Visual Studio 2010 を管理者として開きます。
[ファイル] をクリックし、[新規作成] をクリックし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログ ボックスで、[Visual C#]、次に [クラス ライブラリ] をクリックし、ソリューションの名前として「DashboardSettingsPage」と入力し、[OK] をクリックします。
重要
サーバーにインストールされるアセンブリの名前は、DashboardSettingsPage.dll である必要があります。この DLL を %ProgramFiles%\Windows Server\Bin\OEM にコピーします。
タブで使用するコントロールを作成します。この例では、設定コントロールの名前は MySettingsControl です。
Class1.cs ファイルの名前を変更します。 たとえば、MySettingTab.cs にします。
AdminCommon.dll ファイルへの参照を追加します。
次の using ステートメントを追加します。
using Microsoft.WindowsServerSolutions.Settings;
次の例に合わせて、名前空間とクラス ヘッダーを変更します。
namespace DashboardSettingsPage { public class MySettingTab : ISettingsData { } }
タブ用に作成したコントロールのインスタンスを作成します。たとえば、次のように入力します。
private MySettingsControl tab;
クラスのコンストラクターを追加します。 次のコード例は、コンストラクターを示しています。
public MySettingTab() { tab = new MySettingsControl(); }
設定の変更を送信する、Commit メソッドを追加します。 次のコード例は、Commit メソッドを示しています。
void ISettingsData.Commit(bool dismissed) { // Implement the code that is required to submit your setting changes }
タブのコントロールを識別する、TabControl メソッドを追加します。次のコード例は、TabControl メソッドを示しています。
System.Windows.Forms.Control ISettingsData.TabControl { get { return tab; } }
タブの一意の識別子を提供する、TabId メソッドを追加します。次のコード例は、TabId メソッドを示しています。
private Guid id = Guid.NewGuid(); Guid ISettingsData.TabId { get { return id; } }
タブの順序を返す、TabOrder メソッドを追加します。次のコード例は、TabOrder メソッドを示しています。
int ISettingsData.TabOrder { get { return 0; } }
注意
タブの順序を定義するには、0 から始まる数値を使用します。 Microsoft 組み込みの設定タブが最初に表示され、定義したタブの順序に基づいてユーザー タブが表示されます。 たとえば 3 つの設定タブがある場合、表示する順序に基づいてタブの順序を 0、1、2 と指定します。
タブのタイトルを提供する、TabTitle メソッドを追加します。次のコード例は、TabTitle メソッドを示しています。
string ISettingsData.TabTitle { get { return "My Settings Tab"; } }
注意
タイトルのテキストも、ローカライズのニーズに合わせてリソース ファイルから指定できます。
保存し、ソリューションをビルドします。
Authenticode 署名によるアセンブリの署名
オペレーティング システムで使用するために、アセンブリを Authenticode で署名する必要があります。 アセンブリの署名の詳細については、「 Authenticode によるコードの署名と確認 (英語の場合があります)」を参照してください。
アセンブリの参照コンピューターへのインストール
ソリューションを正常にビルドした後、DashboardSettingsPage.dll ファイルのコピーを参照コンピューターの次のフォルダーに配置します。
%Programfiles%\Windows Server\Bin\OEM