[Tool] 個人開發工具軟體清單

前言
正所謂「工欲善其事，必先利其器」，使用好的開發工具可以加速你的工作效率，讓你盡早完成工作可以休息片刻摸魚，在自己的部落格中也常介紹一些個人在開發上常用的工具與好用軟體，最近工作上幸運的可以將系統碟 128G SSD 升級為 256G (謝主隆恩)，在重灌的過程中也開始整理平常好用的工作在新電腦重新安裝，於是乎有這想法將平常覺得好用的工具整理唯一篇文章分享給有需要的朋友，整理如下

開發工具

Visual Studio 2019 : 開發 ASP.NET 首選開發 IDE，為地表上最強開發工具

Visual Studio Code :  前端同仁一致推薦，最近開始覺得越來越好用 XD

Rider : 強者同事大力推薦，正在努力熟悉中

資料庫工具

SQL Server Managenent Studio : 管理 MS SQL 資料庫工具

Robo 3T : Mongo 資料庫管理工具

Redis Desktop Manager : Redis 查詢介面可視化的軟體，介紹連結

版本控管工具

TortoiseGit : 老字號 Git 版控工具

SourceTree : Git 版控工具 

Fork : 最近主要在使用的版控工具，介紹連結

記憶體分析工具

DebugDiag Tools : 分析 dump 後自動產生報表懶人工具

Performance Profiler : Visual Studio 中內建記憶體工具

Jetbrains dotMemory : Jetbrains 分析記憶體工具

WinDbg : 記憶體分析工具，最近有出新版

輔助工具

Resharper : 開發人員輔助開發神器 (大推)

Feedly : RSS 訂閱服務工具

Postman : 開發 WebAPI 測試利器

REST Client : VS Code 模擬 Request 套件

Fiddler : 查看 Http 封包工具

Cmder : Windows 下好用的終端機工具

Windows Terminal : 微軟於 2019 年出的終端機工具，介紹連結

Docker for windows : 不多說直接看介紹，介紹連結 

Snagit : 好用的截圖軟體

Rambox : 可同時登入多組 Skype 帳號工具

Chocolatey : Windows 套件管理工具，介紹連結

Notepad2 : 強大的記事本工具

LINQPad : 練習 LINQ 必備工具

Json View Awomware : Chrome 擴充套件，理解 Json 結構的好幫手 介紹連結

ILSpy : 程式碼反組譯工具，介紹連結 

LogPaser : Log 分析工具，介紹連結 

7zip : 壓縮解壓縮軟體

wox : 快速啟動軟體 

balsamiq : 手繪風格繪製工具，大推

若是有好用或是推薦的工具也歡迎隨時一起討論，這份工具清單將會持續更新 hope it helps  :)

Read More

[NET] Execution of user code in the .NET Framework is disabled. Enable "clr enabled" configuration option.

問題 
最近運氣很旺在開發專案時常遇到詭異的案例，前幾天在家裡趕專案時在使用 Visual Studio 2019 開發專案要啟動連接到 Database 時跳出 'Execution of user code in the .NET Framework is disabled. Enable "clr enabled" configuration option.'  第一次遇到這問題覺得挺有趣的，雖然解決方法很簡單但還是簡單紀錄一下處理的過程，若是有不清楚或是錯誤的地方歡迎討論予糾正。

異常現場
異常發生時跳出訊息內容如下

相信對 .NET Framework 有點熟系的都知道 / 聽過 CLR，在微軟 MSDN 與 wiki 分別都有針對 CLR 作為介紹與說明，在此引用 wiki 對 CLR 的定義如下 (相較之下微軟的說明太技術了些)

通用語言執行平台（Common Language Runtime，簡稱CLR）是微軟為他們的.NET的虛擬機器所選用的名稱。它是微軟對通用語言架構（CLI）的實作版本，它定義了一個程式碼執行的環境。CLR執行一種稱為通用中間語言的位元組碼，這個是微軟的通用中間語言實作版本。

SQL Server 2005 開始提供 CLR integration 功能，我們可以透過下列指令取得目前 clr enable 的狀況 

EXEC sp_configure 'clr enabled' 

查詢後可以看到目前系統中 clr enable 的設定

欄位說明如下

name : 設定的名稱

minimum : 設定的最小值

maximum : 設定的最大值

config_value : 配置設定的值

run_value : 當前設定值

解決方案
輸入以下指定，開啟 clr enable 

EXEC sp_configure 'clr enabled', 1
RECONFIGURE 

更新後即可重新查詢更新後的值，即可發現更新成功

大功告成，宣告結案  :)

參考
ASP.NET Core 中的 Kestrel 網頁伺服器實作
SQL Error – Execution of user code in the .NET Framework is disabled. Enable “clr enabled” configuration option
How to Enable SQL Server CLR Integration using T-SQL

Read More

[C#] 設定方法 (Method) 已過時 - Obsolete

前言
最近又再重操舊業開始撰寫共用 Library，共用 Library主要用意是希望可以加速同事開發上的速度，像是與 DB 溝通或是撰寫 CRUD 每個專案都會用到的 function 或是 API，或者是每個專案都會用到的檢查邏輯抽出來讓大家使用，讓大家不用在重複造輪子以加速其他同仁在專案上的開發速度，在此專案開發時由於迭代的速度與變化較快，因此也常遇到第一版提供的 API V1 版本經過兩天後就調整為 V2 版本提供新版，此時方案或專案中勢必會有已經在使用的 V1 的 method，最快速地解法就是直接使用 resharper rename ( Ctrl + R + R ) 將參考到的方法一併換掉，簡單又迅速不花太多時間，今天要介紹的是另外一種作法是使用  Obsolete  屬性，提醒其他開發者所定義的 method 已經過期 / 過時，這篇就針對 Obsolete 此屬性做簡單介紹，若有更好的方式歡迎隨時提出來一起討論。

使用方式
 ObsoleteAttribute  位於 system 的命名空間( namespace)，因此要使用時不需要 using 其他 namespace 就可以使用，在 ObsoleteAttribute 提供三組 API 簽章讓開發者來設定方法已過時或是棄用，針對各 API 使用分別介紹如下

ObsoleteAttribute
可以在過時的方法上加上 obsoletAttribute，使用沒有參數的建構子方法，下面為定義 method1 已過時

[Obsolete]
public static string Method1()
{
    return "I'm method1 !!";
}
static void Main(string[] args)
{
    Method1();
}

將滑鼠游標移至 Method1 上方時，可以看到參考到過時的方法時下方會出現淡綠色線，Visual Studio IDE 會提示開發者該方法已過時 ( Method1 is Obsolete)

ObsoleteAttribute(String)
第一種方式提示的訊息都是固定的 xxx is obsolete，如果希望提示訊息可以客製化可以使用此方法簽章，舉例來說 method1 已棄用，希望開發者在使用時可以改用 method2，可以參考下列 sample code

[Obsolete("Method is obsolete :( please use method2")]
public static void Method1()
{
    Console.WriteLine("I'm method1 !!");
}

public static void Method2()
{
    Console.WriteLine("I'm method2 !!");
}

static void Main(string[] args)
{
    Method1();
}

將滑鼠游標移至 Method1 上方時，可以看到參考到過時的方法會呈現自訂的訊息內容

ObsoleteAttribute(String, Boolean)
此簽章包含下列兩個屬性

Message : 型別為字串，定義過時 / 棄用方法要提示開發者的訊息

IsError : 型別為 bool，定義在編譯時是否要錯誤 (true)，如果不希望編譯時產生錯誤只是警告開發者則設定為 false

舉例來說希望強制有使用/參考到 method1 方法的類別都無法使用，則需要設定 IsError 為 true，參考下列 sample code

[Obsolete("Method1 is not support, Please use method2", true)]
public static void Method1()
{
    Console.WriteLine("I'm method1 !!");
}

public static void Method2()
{
    Console.WriteLine("I'm method2 !!");
}

static void Main(string[] args)
{
    Method1();
}

與上面的都不一樣，在編譯則會跳錯誤並提示開發者你所定義的訊息內容，如下所示

希望透過以上的說明，可以讓大家對於在 C# 中如何設定方法過期/棄用時更加了解，如果有不清楚的地方歡迎一起討論，hope it helps !

參考

Using the Obsolete Attribute in C#

Read More

[VisualStudio] VisualStudio 2019 開啟專案失敗 InternalErrorException: File should not depend on itself.

問題 
今天在公司與同事共同開發專案時發生離奇的問題，同事反映要使用 Visual Studio 開啟版控的專案時發生 發生異常，Visual Studio 顯示錯誤訊息為 'System.AggregateException: One or more errors occurred. ---> Microsoft.Assumes+InternalErrorException: File should not depend on itself. ' ，這篇文章就針對此問題的解決方式做分享，若是有不清楚或是錯誤的地方歡迎討論予糾正。

案發現場
當使用 Visual Studio 開啟專案時會無法正常開啟，異常發生時畫面如下

點選確定之後，可以看到異常的方案檔在這時候出現 unloaded 的字眼出現，接著整個專案檔內容也因為讀取失敗，而無法看到專案檔底下的資訊，如下圖所示

接著開啟 log 檔案中可以看到加載失敗的錯誤訊息資訊，Log 內容如下

  System.AggregateException: One or more errors occurred. ---> Microsoft.Assumes+InternalErrorException: File should not depend on itself.
   at Microsoft.VisualStudio.ProjectSystem.VS.Implementation.Package.ProjectFactory.Prefetcher.<LoadProjectAsync>d__20.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
   at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
   at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
   at Microsoft.VisualStudio.Threading.JoinableTask.CompleteOnCurrentThread()
   at Microsoft.VisualStudio.Threading.JoinableTask`1.CompleteOnCurrentThread()
   at Microsoft.VisualStudio.ProjectSystem.VS.Implementation.Package.ProjectFactory.CreateProject(String fileName, String location, String name, UInt32 flags, Guid& projectIid, IntPtr& project, Int32& canceled)
   at Microsoft.VisualStudio.Shell.Flavor.FlavoredProjectFactoryBase.Microsoft.VisualStudio.Shell.Interop.IVsProjectFactory.CreateProject(String fileName, String location, String name, UInt32 flags, Guid& projectGuid, IntPtr& project, Int32& canceled)
   --- End of inner exception stack trace ---
=================== 

從錯誤訊息中看不出可能異常的原因，由於專案是全新的剛剛才 commit 進版控，因此也無法從版控更改紀錄來確認是異動哪裡的 Code 造成異常， .csproj  主要是用來定義專案的內容，是由數組 XML 元素組合而成，像是此專案所用到的 TargetFramework 就會定義在  .csproj  中，因此遇到此情況只能逐一查看專案檔  .csproj  內的 XML 元素是否有異常而造成 Visual Studio 無法讀取，經過一段時間的抽絲剝繭之後發現問題在專案檔中的下列區塊

<Project>
  <!--省略-->
  <ItemGroup>
    <None Update="appsettings.Development.yml">
      <DependentUpon>appsettings.yml</DependentUpon>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="appsettings.Production.yml">
      <DependentUpon>appsettings.yml</DependentUpon>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="appsettings.yml">
      <DependentUpon>appsettings.yml</DependentUpon>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
  </ItemGroup>
</Project>

可以看到在上述 ItemGroup 區塊中定義三個項目，主要用意是希望設定檔 appsettings 將前墜字串相同但環境不同的 Config 整合再一起，在 Visual Studio IDE 統一顯示在一個區塊中才不會在散落各地，因此在這使用  DependentUpon  屬性來定義所依賴的檔案，但也可以發現造成無法開啟專案檔的兇手在此，造成異常的原因為 appsettings.yml 內的 DependentUpon 屬性定義依賴的檔案為自己，在比對一開始錯誤訊息內容 File should not depend on itself.，就瞬間恍然大悟秒懂錯誤訊息所表達的意思 (在沒發現之前很難意會 XD)，了解原因之後修復的動作也很簡單，將 appsettings.yml 中的 DependentUpon 移除，並 reload Project 就可以正常開啟專案，正常畫面如下

解決完畢宣告除蟲大成功 !!!

參考
Common MSBuild project items

Read More