在 NuGet 套件中加入 XML 文件註解
寫程式的時候要養成寫好註解的習慣,讓後續接手的開發者能容易的知道該段程式碼在做甚麼,開發通用的套件時也是一樣,讓開發者能在使用你所打造的 API 時,能透過 XML 文件註解(C# XML Documentation Comments)來清楚知道該 API 的用途是什麼,這樣可以提升軟體品質,且有助於開發效率。
寫程式的時候要養成寫好註解的習慣,讓後續接手的開發者能容易的知道該段程式碼在做甚麼,開發通用的套件時也是一樣,讓開發者能在使用你所打造的 API 時,能透過 XML 文件註解(C# XML Documentation Comments)來清楚知道該 API 的用途是什麼,這樣可以提升軟體品質,且有助於開發效率。
我所認為的證照,他所代表的意義其實覆蓋了一層機率,用白話文說就是:證照代表你有可能知道的比較多一點,在現在技術的洪流中,即便是同一個技術領域,也可能在幾年內汰舊換新,而證照或許是快速識別你是否有可能提供專業的技能。
在網頁上預覽檔案的需求越來越常見,尤其是 Office 類型的檔案,使用者希望能在不用另存檔案的情況下,直接在網頁上預覽,過去比較常見的對應方式是將 Office 檔案轉成 PDF 檔,在透過 PDF.js 或其他 JavaScript 函示庫來處理,但缺點就在於要先將 Office 檔案轉成 PDF 才能呈現,這裡提供兩種方式,讓你能在網頁上快速成預覽 Office 檔案。
這是一個逼不得已的做法,為了要讓 .NET Framework 專案總是使用最新的 NuGet 套件,讓每次部屬都用最新的套件功能,試出了這樣的處理方式。
最近使用 Docker 時遇到個小狀況,每次下 docker ps
查看容器資訊的時候,所輸出的資訊太多,斷行的結果造成閱讀困難,於是就在想,這個輸出應該可以被格式化吧,只顯示部分我比較關心的欄位就好了,於是找了一下官方文件,docker ps --format
是這次狀況的好夥伴。
在使用複雜的 JSON 資料作為呼叫 ASP.NET Core WebAPI 的 HTTP Body 的時候,ASP.NET Core 會將 JSON 資料做對應的模型繫結,當模型繫結失敗的時候,ASP.NET Core WebAPI 有預設的錯誤訊息回饋給呼叫端,而在 ASP.NET Core 的架構中,保留了很多修改的彈性,如何自訂 ASP.NET Core WebAPI 模型繫結的驗證訊息,是這篇想要介紹的。
每當有新人進公司的時候,前三個月總是免不了接受許多公司內部的教育訓練,這些教育訓練內容無非是希望新進人員能快速上手一些公司內部既有的流程,甚至針對所任職的工作內容能有進一步的認識,如果公司內部已經使用許多 Microsoft 的服務,甚至 .NET 相關的開發技術,都可以透過 Microsoft Learn 來作為新進人員的教育訓練,重點是有中文還免費!
7 歲的時候家裡出現了一台舊舊大機器,一台跑著 MS DOS 的 80386,我不知道他能做甚麼,接著一台像是小型電視機的螢幕,有個像打字機的鍵盤,感覺好像是一個練習 ㄅㄆㄇㄈ 的機器,而這台機器揭開了資訊之路的序幕。
程式碼的版本控制是專案很重要的一個環節,當專案越長越大,歷時也越來越悠久的時候,你會發現 Git 的版本紀錄 (Commits) 會非常多,除非你用 Git 指令來操作,否則用有介面的版本控制工具都很容易卡在讀取過多 Commits,或是在繪製 Commits Tree 的時候卡很久,如果你剛好是使用 SourceTree 作為版本控制工具, 這裡有個設定你可以參考一下。
最近愛上使用 Windows Terminal 來當作終端機工具,讓你可以將多種 Shell 整合在一起使用,包括 Windows 內建的 cmd,在 Windows 運行 Linux 環境的 WSL,用於管理 Azure 資源的 Azure Cloud Shell,以及本篇想要分享的 PowerShell,然而經常在各種 Shell 切換的過程中,難免會有些指令工具覺得好用,卻在另一個 Shell 中沒那個指令可以用,這篇將分享如何讓你的 PowerShell 變得順手、更好用。