by WebSurfer
28. December 2025 14:28
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 からインストールしたパッケージおよびそのバージョンは以下の通りです。バージョンはこの記事を書いた時点での最新版です。
-
AjaxControlToolkit v20.1.0
-
Antlr v3.5.0.2
-
HtmlAgilityPack v1.12.4
-
Microsoft.AspNet.Web.Optimization v1.1.3
-
Microsoft.Web.Infrastructure v2.0.0
-
Newtonsoft.Json v13.0.4
-
WebGrease v1.6.0
-
AjaxControlToolkit.HtmlEditor.Sanitizer v20.1.0
-
Microsoft.AspNet.Web.Optimization.WebForms v1.1.3
-
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 を以下のように修正します。
-
<trust level="Medium" /> を削除
-
siteMap / providers 要素に <remove name="MySqlSiteMapProvider" /> を追加
以上でデモは動くはずです。
(メモ: C:\WebSites2026\AjaxControlToolkit.SampleSiteVisual フォルダにある Web サイトプロジェクト。Visual Studio でそのフォルダ下の AjaxControlToolkit.SampleSite.sln を選んで開けばサンプルが動く)
9a1121cb-653e-41fe-9fc0-2c073fd321d1|0|.0
Tags: ACT, Demos
AJAX