[打造自己的template-建立一致性程式碼][06]建立Item Template

2017-08-31 Thursday

在上篇（[05]建立多專案(multi project)的Template）了解了如何建立Multi Project了之後， Project Template基本上就告一個段落了。

在這篇則是針對另外一種Template：Item Template的建立方式做一個介紹。

建立Item Template

Item Template是在建立在專案裡面項目的時候可以選的一種template。以我們的例子來說，今天要寫一個ProcessTemplate，那麼最快的方式就是建立一個class繼承BaseExecuteProcessTemplate。

因此假設在建立class的時候，這個繼承關係就建立好了，開發者根本不需要看文件確認繼承的class名稱，加快開發者開發並且程式碼一致，這就是Item Template的價值所在。

如果要建立一個Item Template，基本上和Project Template差不多：

想必在建立Project Template匯出的時候，應該有注意到另外一個選項是Item Template。

因此，就是透過選Item Template、再來選擇哪個Class（只能夠單選）、再來選擇要包含的dll最後填完資訊就匯出完成了。

同Project Template一樣，匯出的路徑一樣在（預設）%userprofile%\Documents\Visual Studio {version}\My Exported Templates

這邊reference的時候不會包含實際的dll，所以如果那台機器沒有裝那個dll在gac - 基本上會有問題。因此不建議加入非gac的dll

同Project Template一樣，不建議勾選 Automatically Import the template into visual studio

同Project Template一樣，Item Template也有分兩個位置：

系統等級

這個放的位置在：

\{VisualStudioInstallationDirectory}\Common7\IDE\ProjectTemplates\{Language}\{category\\{Locale}\

舉例來說：

c:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\ProjectTemplates\CSharp\Web\1033\WebApplicationProject40\

這個template是VS 2017在C#->Web->英文(1033)的WebApplicationProject40專案位置

一般來說，這邊路徑的template不會去動。

使用者等級

這個預設放在： \{My Documents}\{Visual Studio Version}\Templates\ItemTemplates\{Language}\

例如： C:\Documents and Settings\UserName\My Documents\Visual Studio Version\Templates\ItemTemplates\Visual C#\放的是C#範本的位置

使用者等級是可以改的，在VS裡面的Option -> Projects and Soultion那邊是可以調整的，因此如果等一下範本匯入沒有作用，確認一下這邊的路徑是否正確。

因此把匯出的zip檔案丟到正確的位置（如果需要「分類」記得依照結構建立即可，如果不確定請參考：[04]了解vstemplate來微調匯出的Template和強制VS更新Template的方式#管理Project Template到某個分類）

如果丟入路徑正確，可以再建立的時候找到

假設VS沒有出現，可以把cache刪掉看看，cache路徑%appdata%\Microsoft\VisualStudio\ItemTemplatesCache。（如果不清楚可以參考[04]了解vstemplate來微調匯出的Template和強制VS更新Template的方式#更新template - 如何讓vs重新刷新）只需要注意Item Template是ItemTemplateCache