破解System.Web.Helpers 2.0.0.0與3.0.0.0之謎

破解System.Web.Helpers 2.0.0.0與3.0.0.0之謎

Error 2

System.Web.Helpers命名空間是.NET Framework裡一個神秘的組織，它和ASP.NET MVC 3一起推出，知道和用它的人並不多，它暗地裡提供許多便利型的功能(可以參考之前寫的系列文(1、2、3、4、5、6、7、8)。但如上圖所見，它在我VS2015裡的新專案裡就這樣赤裸裸的爆開，開啟著另一個VS2013的專案，怎麼一切安然無事。當下會很直覺的想罵聲－暗，是不是命中帶ㄕㄞˋ，老是碰到這種鬼錯誤。但有幾次VS2015的經驗，我改變心態，耐著性子一路追下去，意外發現System.Web.Helper一件不為人知的故事。

專案實況還原

以下我將用最簡化的方式來還原當時專案的狀況。

Helper專案

加入參考

我們有一個Helper專案，裡面有一個方法使用System.Web.Helpers.Crypto.SHA1()來進行加密動作。此Helper專案會讓其他專案進行使用。

  using System.Web.Helpers;

  namespace HelperSample
  {
      public class Signature
      {
          public static string Get(string token)
          {
              return Crypto.SHA1(token);
          }
      }
  }

MVC專案

  1. 加入一個「Web - Empty - MVC 核心參考」的網站。
  2. 加入Helper專案參考。

呼叫Signature.Get()驗證功能是否正常。

  using HelperSample;
  using System.Web.Mvc;

  namespace MVCSample.Controllers
  {
      public class HomeController : Controller
      {
          // GET: Home
          public ActionResult Index()
          {
              ViewBag.SHA1 = Signature.Get("Bruce");
              return View();
          }
      }
  }
MVC View

Very Good.

Web API專案

同MVC專案，我們再加入一個Web API專案。

  1. 加入一個「Web - Empty - Web API 核心參考」的服務專案。
  2. 加入Helper專案參考。

呼叫Signature.Get()驗證功能是否正常。

 using HelperSample;
 using System.Web.Http;

 namespace APISample.Controllers
 {
     public class CheckController : ApiController
     {
         public string Get()
         {
             return Signature.Get("Bruce");
         }
     }
 }
FileNotFoundException

比對一下MVC專案與API專案的參考。

Check參考

從圖上來看，MVC專案有幫我們加入System.Web.Helpers的參考，API專案不列為核心參考也合情合理，就在API專案把System.Web.Helpers加上吧。

不過一啟動API服務就…

ErrorMessage 1
ErrorMessage 2

我不是明明加入了System.Web.Helpers的參考嗎？反覆看著錯誤訊息，是發現2.0.0.0與3.0.0.0問題，但怎麼會這樣呢？

API與Helper專案的System.Web.Helpers屬性

系統參考

MVC專案的System.Web.Helpers屬性

NuGet參考

為什麼MVC專案裡的是3.0.0.0的版本？

System.Web.Helpers 3.0.0.0之謎

上面最後兩張圖屬性圖，幾乎讓答案呼之欲出。比對兩張圖，除了版本號不同外，還就有就路徑不同。由系統參考的會指向C:\Program Files (x86)\Microsoft ASP.NET\ASP.NET Web Pages\v2.0\Assemblies\System.Web.Helpers.dll這支DLL。但MVC專案是指向Z:\{project_path}\packages\Microsoft.AspNet.Webpages.3.2.3\lib\net45\System.Web.Helpers.dll。

看到關鍵字了嗎？

原來，MVC中的System.Web.Helpers是由Microsoft ASP.NET Web Pages套件來提供。

那麼，API專案中，我明明已經加入系統參考2.0.0.0版本，它怎麼那麼聰明的知道有個3.0.0.0版本，而且我還不用不行呢？

Assembly Redirect

感謝好友Dino Wang提供Assembly Redirect明燈。

在前述的錯誤訊息裡有一句：

記錄: 在應用程式組態檔中找到重新導向: 重新導向 2.0.0.0 至 3.0.0.0。

開啟API專案的Web.config(明年我就會想念它了)：

Assembly Redirect

這樣的設置與系統給出的錯誤訊息是相吻合的。茶包，你就安心走吧。

要讓API專案能正常運作，就要安裝Microsoft.AspNet.WebPages套件。

如果想玩玩可重視環境，這裡有GitHub範例專案：SystemWebHelperTrace

標籤： , , , 張貼者： 於

沒有留言:

張貼留言

感謝您的留言，如果我的文章你喜歡或對你有幫助，按個「讚」或「分享」它，我會很高興的。

訂閱： 張貼留言 (Atom)