記錄檔 (POS for .NET v1.14 SDK 文件)
Microsoft Point of Service for .NET (POS for .NET) 包含記錄功能，可用來錄製 POS for .NET、服務物件與應用程式事件。 記錄參數會從 POS for .NET 登錄機碼 \HKLM\SOFTWARE\POSfor.NET\Logging 讀取，並利用 Logger 類別寫入項目。
啟用記錄
當登錄機碼 \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled 設定為非零值時，就會啟用記錄。
記錄檔大小
登錄機碼 \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB 會指定記錄檔的大小上限。 如果啟用記錄時超過此檔案大小，記錄會停止。 不會向應用程式傳回任何例外狀況或錯誤。
根據預設，記錄檔大小上限為 10 百萬位元組 (MB)。
記錄檔位置
登錄機碼 \HKLM\SOFTWARE\POSfor.NET\Logging\location 可用來判斷寫入記錄檔的位置。
根據預設，此位置設定為環境變數 %TEMP%，在 Windows 預設為目錄 C:\Documents and Settings\(username)\Local Settings\temp。這是每個使用者目錄。
記錄檔名稱
記錄檔名稱由三個元素組成：
- 登錄機碼 \HKLM\SOFTWARE\POSfor.NET\Logging\Name 包含基底檔案名稱。 此值的預設為 PosFor.Net。
- 此格式的時間戳記：(yyyy-mm-dd hh-mm-ssZ)
- 副檔名為 .txt。
這是一般記錄檔名稱的範例：
PosFor.Net(2006-08-10 18-33-29Z).txt
記錄檔標頭
標頭包含使用者、OS、呼叫執行緒與流程等等資訊，在建立記錄檔時會寫入每個記錄檔。 此標頭包含下欄欄位：
- 目前使用者：目前使用者的名稱。
- 電腦名稱：建立記錄的電腦名稱。
- OS 版本：正在執行的 Windows 版本，包括 Service Pack。
- .Net 執行階段：.NET 執行階段的版本。
- 流程識別碼：建立記錄檔的流程 PID。
- 執行緒識別碼：建立記錄檔的執行緒。
- 記錄檔大小上限：此記錄檔可用的檔案大小上限。
- 檔案：建立記錄檔的可執行檔名稱。
- InternalName：可執行檔的內部名稱。
- OriginalFilename：可執行檔的原始名稱。
- FileVersion：儲存在可執行檔的版本資訊。
- FileDescription：儲存在可執行檔的說明。
- 產品：儲存在可執行檔的產品說明。
- ProductVersion：儲存在可執行檔的檔案版本。
- 偵錯：偵錯旗標。
- 已修補：已修補的檔案。
- 發行前版本：發行前旗標。
- PrivateBuild：私人組建旗標。
- SpecialBuild：特殊組建旗標。
- 語言：用來建立記錄檔的語言。
記錄檔輸入
記錄輸入可由 POS for .NET 建立，或由應用程式或服務物件建立。 輸入的建立方式是在記錄器類別的執行個體呼叫適當方法。
每項輸入包含下列欄位：
時間戳記。
建立輸入的執行緒識別碼。
重要性層級。 每個記錄輸入都會標示其重要性層級，由涉及的記錄器方法決定。
記錄輸入的重要性標記 對應的記錄器方法 INFO Logger.Info 警告 Logger.Warning 錯誤 Logger.Error 名稱字串，由呼叫記錄器方法的程式碼指定。 當叫用記錄器方法時會指定此字串，而且未必包含可執行檔的名稱。
例如，典型的記錄檔輸入如下所示：[8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()
註解
如果開啟記錄檔，且應用程式呼叫 Refresh() 方法，則會關閉檔案，並利用更新的時間戳記來建立新記錄檔。
