Ajax Control Toolkit の最新版かつ最終版 v20.1.0 のデモを自分の開発環境で動くようにする手順を備忘録として書いておきます。基本的には先の記事「Ajax Control Toolkit 17.1.1 デモ」の v17.1.1 の場合とほぼ同じですが、入手する .zip ファイルとか、NuGet パッケージのバージョンとか、Visual Studio 2026 を使ったところなどが異なります。

まず、GitHub のページ DevExpress/AjaxControlToolkit の下の方の Assets 欄の［Source code (zip)］をクリックして AjaxControlToolkit-20.1.0.zip をダウンロードします。

ダウンロードしたファイル AjaxControlToolkit-20.1.0.zip の中に AjaxControlToolkit.SampleSite というフォルダがあるので、それを丸ごと解凍して適当な場所にコピーします。

そのホルダには Web サイトプロジェクト形式の ASP.NET Web Forms アプリが含まれています。ただし、そのフォルダ内の bin フォルダには AjaxControlToolkit.dll など必要な .dll が含まれていないので、そのままでは動きません。NuGet から必要なパッケージをインストールする必要があります。

NuGet から必要なパッケージをインストールするには、Visual Studio 2026 を使っていれば Tools > NuGet Package Manager > NuGet Package Manager for Solution... から管理画面を開いて行うと思いますが、そのためにはソリューションとしてアプリを開いていないとダメなようです。しかし、ダウンロードした AjaxControlToolkit.SampleSite フォルダには .sln ファイルは含まれていません。

.sln ファイルを作成するには、一旦、Visual Studio 2026 の File > Open > Web Site... で AjaxControlToolkit.SampleSite フォルダを開いた後、Visual Studio 2026 を閉じると下のダイアログが表れるので、[Save] ボタンをクリックしてやります。そうすれば指定した場所に .sln ファイルを生成してくれます。（ほかにもっと簡単な方法があるかもしれませんが）

その後、Visual Studio 2026 を起動し、File > Open > Project/Solution... で上の操作で生成された .sln ファイルを選んでプロジェクトを開いてやれば、 Tools > NuGet Package Manager > NuGet Package Manager for Solution... で管理画面を開くことができます。

自分が NuGet からインストールしたパッケージおよびそのバージョンは以下の通りです。バージョンはこの記事を書いた時点での最新版です。

1. AjaxControlToolkit v20.1.0
2. Antlr v3.5.0.2
3. HtmlAgilityPack v1.12.4
4. Microsoft.AspNet.Web.Optimization v1.1.3
5. Microsoft.Web.Infrastructure v2.0.0
6. Newtonsoft.Json v13.0.4
7. WebGrease v1.6.0
8. AjaxControlToolkit.HtmlEditor.Sanitizer v20.1.0
9. Microsoft.AspNet.Web.Optimization.WebForms v1.1.3
10. AjaxControlToolkit.StaticResources　v20.1.0

上のリストの 1 番目の AjaxControlToolkit をインストールすると 2 ～ 7 番目の NuGet パッケージも同時にインストールされるはずです。ただし、バージョンが古いものがあったので最新版にアップデートしました。加えて 8 ～ 10 番の 3 つの NuGet パッケージも管理画面でインストールします。

上に書いた NuGet でのパッケージのインストールが完了するとアプリケーションの bin フォルダは以下のようになるはずです。

自分が上の操作を行った時、何が問題だったのか不明ですが、System.Web.Optimization.dll がインストールされず (.refresh のまま)、実行すると「型または名前空間名 'Optimization' は名前空間 'System.Web' に存在しません。アセンブリ参照が不足しています。」というエラーになりました。

その問題は、関係する以下の NuGet パッケージをアンインストールしてから再インストールすることで解決できました。

• Microsoft.AspNet.Web.Optimization
• Microsoft.AspNet.Web.Optimization.WebForms
• AjaxControlToolkit.StaticResources

最後に web.config を以下のように修正します。

1. <trust level="Medium" /> を削除
2. siteMap / providers 要素に <remove name="MySqlSiteMapProvider" /> を追加

以上でデモは動くはずです。

（メモ: C:\WebSites2026\AjaxControlToolkit.SampleSiteVisual フォルダにある Web サイトプロジェクト。Visual Studio でそのフォルダ下の AjaxControlToolkit.SampleSite.sln を選んで開けばサンプルが動く）

Ajax Control Toolkit の最新版（この記事を書いた時点では v17.1.1.0）のデモを自分の開発環境で動くようにする手順を備忘録として書いておきます。

2025/12/28 追記: Ajax Control Toolkit の最新版かつ最終版 v20.1.0 については別の記事「AJAX Control Toolkit 20.1.0 デモ」に書きましたのでそちらを見てください。

DevExpress のサイト ASP.NET AJAX Control Toolkit Demos にデモは公開されていますが、自分の開発環境に同じものをインストールし、ソースコードを見たりデバッグ実行したいということがあると思います。

そのためには、まず、GitHub のサイト DevExpress/AjaxControlToolkit から AjaxControlToolkit-master.zip をダウンロードします。

ダウンロードしたファイル AjaxControlToolkit-master.zip の中に AjaxControlToolkit.SampleSite というフォルダがあるので、それを丸ごと解凍して適当な場所にコピーします。

v7.x までは、それを Visual Studio で開いて［デバッグ(D)］⇒［デバッグなしで開始(H)］で実行すれば動いたのですが、v17.1.1.0 では AjaxControlToolkit が見つからないというエラーになります。

基本的には NuGet で必要なパッケージをインストールして web.config を一部修正すれば動くようになるのですが、かなり多くのパッケージをインストールしなければならず、エラーメッセージも意味不明なものがあり、動くようになるまで 2 日ほどハマってしまいました。（笑）

自分が NuGet からインストールしたパッケージおよびそのバージョンは以下の通りです。

1. AjaxControlToolkit v17.1.1
2. Microsoft.AspNet.Web.Optimization v1.1.3
3. Microsoft.AspNet.Web.Optimization.WebForms v1.1.3
4. AjaxControlToolkit.StaticResources　v17.1.1
5. WebGrease v1.6.0
6. AjaxControlToolkit.HtmlEditor.Sanitizer v17.1.1
7. HtmlAgilityPack v1.6.7
8. Antlr v3.5.0.2
9. Newtonsoft.Json v10.0.3
10. Microsoft.Web.Infrastructure v1.0.0

web.config の修正箇所は以下の通りです。

1. <trust level="Medium" /> を削除（理由不明ですが Visual Studio 2015 で IIS Express 64-bt で動かした場合はこれがあるとダメ）
2. siteMap / providers 要素に <remove name="MySqlSiteMapProvider" /> を追加（これは MySQL の Connector/NET をインストールした自分の環境固有の問題）

上に書いた NuGet でのパッケージのインストールが完了するとアプリケーションの bin フォルダは以下のようになるはずです。

以下に自分的に注意すべきと思う点を書いておきます。

WebGrease, HtmlAgilityPack など［ソリューションの NuGet パッケージの管理］ではインストール済みと表示されるものがあります。その場合、新しいバージョンがリリースされていたら更新することでインストールできます。

Microsoft.Web.Infrastructure は新しいバージョンがない（1.0.0 しかない）ので［ソリューションの NuGet パッケージの管理］ではインストールできません。その場合は［パッケージマネージャーコンソール(O)］で以下のようにしてインストールできます。

Update-Package -reinstall Microsoft.Web.Infrastructure

HtmlEditorExtender には AjaxControlToolkit.HtmlEditor.Sanitizer が必要です。これなしで起動しようとすると以下のように "値を Null にすることはできません。パラメータ名:Type" という意味不明なエラーになります。これの原因が分からなくてハマりました。（汗）

加えて、HtmlAgilityPack も必要です。もういい加減にカンベンしてって感じだったのですが、一応ここまででとりあえず動くようにはなりました。（笑）

（C:\WebSites2015\AjaxControlToolkit.SampleSite フォルダにある Web サイトプロジェクト。Visual Studio でそのフォルダを選んで開けばサンプルが動く）