[.NET/Tool] Common.Logging與Log4Net的差異與使用

問題：
專案中會看到同時參考Common.Logging與Log4Net，Log4Net就可以輸出Log了，為何還需要Common.Logging?


說明：
專案是可以互相參考的，專案A使用Log4Net輸出log，專案B卻使用NLog，造成管理的不便，
此時使用Common.Logging可提供抽象，由Log4net等dll來實作這些方法，
可以整合Log4net或NLog等.NET常見的Log函式庫，讓專案間可以使用Common.Logging來當Interface。

使用NuGet加入Common.Logging後，using與建立log物件，如下圖：
在app.config加入Logging Configuration後(使用ConsoleOutLoggerFactoryAdapter)，
即可輸出Console。

搭配Log4Net，使用NuGet加入Common.Logging.Log4Net1215(目前最新)，NuGet就會自動加入對應的Log4Net版本1.2.15(package version為2.0.5)，
一樣需設定Logging Configuration，即可輸出Console。




Logging Configuration需注意的是：
● factoryAdapter內的type屬性，最後的Common.Logging.Log4Net1215版本號需正確。
● factoryAdapter下的ConfigType屬性設為INLINE表示讀取專案app.config內設定，若沒設定該屬性，則須有外部設定檔。

輸出外部log，可使用RollingFileAppender。

附上Log4Net版本號與NuGet package version對應，如1.2.15對應NuGet 2.0.5。

參考資料：
http://netcommon.sourceforge.net/docs/2.1.0/reference/html/ch01.html
http://logging.apache.org/log4net/release/config-examples.html
https://cmatskas.com/extend-the-common-logging-api-with-log4net/
https://github.com/net-commons/common-logging/wiki/Common.Logging-Packaging-and-Versions
http://stackoverflow.com/questions/37171988/nuget-package-version-not-matching-reference-version

[C#] 使用Microsoft.Interop.Excel將Excel文件列印在同一頁(PageSetup)

說明：
將欄位較多的Excel文件自動列印在同一頁(將所有欄放入單一頁面)。


作法：
using Excel = Microsoft.Office.Interop.Excel;

Excel.Application excel = new Excel.Application();
Excel.Workbook workbook = excel.Workbooks.Open(excelPath);
Excel.Worksheet worksheet = (Excel.Worksheet)workbook.ActiveSheet;

//Fit all columns on one page
excel.PrintCommunication = false;
Excel.PageSetup pageSetup = worksheet.PageSetup;
//FitToPagesTall property設為false，則以FitToPagesWide來縮放Worksheet
pageSetup.FitToPagesTall = false;
pageSetup.FitToPagesWide = 1;
excel.PrintCommunication = true;

workbook.Save();
worksheet.PrintOutEx();
workbook.Close();
excel.Quit();


參考來源：
https://msdn.microsoft.com/en-us/library/microsoft.office.interop.excel.pagesetup.fittopagestall(v=office.15).aspx
http://stackoverflow.com/questions/25741049/how-to-set-fit-all-columns-on-one-page-in-print-tab

[.NET] 使用HtmlAgilityPack與HAPXPathFinder擷取網頁上的資料

說明：
想擷取網頁上的資料，該怎麼做?

作法：
寫.NET的可以使用HtmlAgilityPack這個套件，可透過NuGet或自行下載後加入參考，
這裡以擷取統一發票中獎號碼為例(網址：http://invoice.etax.nat.gov.tw/)。

假設想擷取特別獎號碼，需要知道它的XPath，何謂XPath呢?
XPath(XML Path Languange)，用來尋找XML檔案中的節點，詳細語法可參閱[1][2]。
一般而言，網頁的XPath大多像這樣：/html/body/div[1]/table[1]/tr[1]/td[1]。

找尋XPath主要有兩種方法：
● 檢視網頁原始碼來找尋XPath，或按F12開發者工具，再點選「選取元素」自行剖析XPath，Chrome可右鍵->Copy->Copy XPath。

● 使用HAPXPathFinder[3]，曾自行剖析某網頁XPath，程式卻一直找不到該節點，使用HAPXPathFinder發現，該XPath沒有html tag...。因各瀏覽器產生的DOM有所差異，
使用HAPXPathFinder可以準確找出HtmlAgilityPack DOM的XPath。
打開HAPXPathFinder，在「Browser」tab輸入URL後，點選「DOM Tree」tab，
在TextBox輸入尋找內容->點選「Find」->點選右方Text區塊的搜尋結果
(->點選左方區塊的標示節點)->中間區塊即有節點的XPath(/#text[1]不需要)。如：

有了URL與XPath，就可以使用HtmlDocument.DocumentNode.SelectSingleNode方法的InnerText屬性來取得號碼了。 若找不到資料，可能是網頁編碼的問題，該網頁編碼使用UTF8。

參考資料：
[1] http://www.w3schools.com/xsl/xpath_syntax.asp
[2] https://msdn.microsoft.com/zh-tw/library/ms256086(v=vs.120).aspx
[3] https://hapxpathfinder.codeplex.com/

[.NET] 使用Sandcastle製作軟體help file的sample code

說明：
軟體開發完成後，需要有說明文件方便使用者查詢使用，
微軟有提供CHM(Compiled HTML)的說明檔格式，
使用Sandcastle與GhostDoc(professional版以上)都可產出CHM help file，
但如果還想要加入sample code的頁面，該如何做呢?


作法：
可使用Sandcastle Help File Builder(SHFB)這套免費工具，又是獨立的編譯器，使用上也較方便。

● 先下載SHFB(http://shfb.codeplex.com/)並安裝，安裝後執行Sandcastle Help File Builder GUI。

● 上方選單列->File->New Project->輸入專案名稱並存檔。

● 在右方Project Explorer中的Documentation Sources上右鍵，選擇Add Documentation Sources...，加入軟體專案編譯後的dll與XML，(專案XML需在專案屬性->建置->輸出區塊，勾選XML文件檔案)。

● 接著在專案名稱上右鍵->Add->New Item，加入Code Snippets與Content Layout，可更改檔名後存檔。

● 點開Code Snippets，將item的id改成需要的名稱，例：SampleCode#NewInstance，sampleCode tag中則是要顯示的程式碼，預設有C#與VB，<可用&lt;、>用&gt;取代。

● 點開Content Layout，點選主畫面左上角的Add a new topic as a sibling of the selected topic，選擇Standard Templates的Sample，填入檔名後Add。

● 點開上一步加入的Sample.aml，在section中的content tag中加上<codeReference>item id</codeReference>，例：

<section address="Section1">
      <title>Create Instance</title>
      <content>
        <para>建立實體物件</para>
        <codeReference>SampleCode#NewInstance</codeReference>
      </content>
</section>

● 調整想要的Project Properties後，上方選單列->Documentation->Build Project，建置結束後，選單列->Documentation->View Help File即可。


參考資料：
http://www.codeproject.com/Articles/141766/Creating-documentation-for-a-NET-component-with-Sa
http://community.submain.com/blogs/tutorials/archive/2014/03/05/conceptual-content-adding-custom-content-to-api-documentation-created-with-ghostdoc.aspx
http://huan-lin.blogspot.com/2009/02/use-sandcastle-file-builder-to-create.html
http://www.codeproject.com/KB/XML/csharpcodedocumentation.aspx?msg=1679454

[.NET/C#] 委派(delegate)的演變 (delegate<T>/anonymous method/Lambda/Func<T>)

說明：整理delegate一路上的演變。

[Programming/Modbus] little-endian與big-endian

endian在CS裡指的是記憶體位址的排列，不同的CPU有不同的endian，電腦常用的Intel x86是little-endian設計，而big-endian設計的有Modbus PLC，與HP、IBM、MOTOROLA 68K系列CPU，究竟差在哪?


65534以1個word表示為0xFFFE，而記憶體是由左而右存放，
放到little-endian的記憶體會是

FE

FF

最低byte存放記憶體最前面，反序排列。

而放到big-endian的記憶體會是

FF

FE

最高byte存放記憶體最前面，依序排列，較適合人讀。

參考資料：
https://en.wikipedia.org/wiki/Endianness

[WebDAV] 如何設定WebDAV的基本驗證(Basic Auth)功能(Server與Client)

說明：
WebDAV (Web-Based Distributed Authoring and Versioning)可透過網路磁碟機將Server上檔案整合進本機磁碟，若要設定WebDAV的基本驗證(Basic Authentication)，Server該如何設定? Client又該如何連接呢?


作法：
● Server(以Windows Server 2012 R2為例)：
1. 安裝WebDAV與基本驗證：
開啟[伺服器管理員] -> 點選新增角色及功能 -> 直到[伺服器角色]tab -> 點開[網頁伺服器] ->
◎ 點開[一般HTTP功能] -> 勾選[WebDAV發行] ->
◎ 再點開[安全性] -> 勾選[基本驗證] -> 安裝。

2. 建立使用者帳戶：
開啟 [電腦管理] -> 點開[系統工具] -> 點開[本機使用者和群組] -> [使用者]上右鍵 -> 新使用者 -> 輸入使用者名稱與密碼。

3. IIS站台新增應用程式與設定：
開啟 [IIS管理員] -> 在站台下新增[應用程式] -> 輸入[別名]與對應實體資料夾 -> 點選剛新增的應用程式 ->
◎ 右側雙擊[WebDAV編寫規則] -> 右鍵[新增編寫規則] -> 在[指定的使用者]輸入新增的使用者名稱，其餘依需求設定 ->
◎ 右側雙擊[驗證] -> 啟用[基本驗證] -> 停用其他驗證方式。

至此，Server已設定完成。


● Client(以Windows 7為例)：
1. 打開[服務] (控制台\所有控制台項目\系統管理工具) -> 啟動[WebClient]。

2. 打開登錄檔 (開始 -> 搜尋視窗打regedit) -> [BasicAuthLevel]改為2 (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel)，表啟用SSL與非SSL的基本驗證 -> reboot。

3. 右鍵[電腦] -> 點選[連線網路磁碟機] -> 在資料夾輸入http://IP或domain name/應用程式名稱
-> 彈出登入視窗 -> 輸入使用者名稱與密碼 -> 送出即可。



參考資料：
https://advancedhomeserver.com/making-a-pc-a-secure-webdav-server/
https://technet.microsoft.com/en-us/library/cc772009(v=ws.10).aspx
https://technet.microsoft.com/zh-tw/library/cc770642.aspx
http://blog.pulipuli.info/2014/07/windows-7owncloudwebdav-map-owncloud.html