Api.DebugMessage 方法

傳送 KINGSTAR 記錄檔訊息到 KINGSTAR 記錄檢視。

命名空間：IntervalZero.KINGSTAR.Local.Api

組合： IntervalZero.KINGSTAR.Local.Api (於 IntervalZero.KINGSTAR.Local.dll) 版本：4.4.0.0

語法

public KsError DebugMessage(
       int Category,
       KsLogSeverity Severity,
       string Message,
       bool AppendValues,
       long Value0 = 0,
       long Value1 = 0,
       double Value2 = 0,
       double Value3 = 0
)

Public Function DebugMessage(
       Category As Integer,
       Severity As KsLogSeverity,
       Message As String,
       AppendValues As Boolean,
       Optional Value0 As Long = 0,
       Optional Value1 As Long = 0,
       Optional Value2 As Double = 0,
       Optional Value3 As Double = 0
) As KsError

參數

Category

型別：int

記錄檔的 ID，使用者自訂義。可使用 SetCategoryName 方法將各 Category 關聯一個字串，此 ID 不需從 0 開始或按順序排列。

Severity

型別：KsLogSeverity

記錄檔的嚴重性等級。

Message

型別：string

說明記錄檔資料的訊息，最多 128 個字元。

AppendValues

型別：bool

true：值有加在 Message 末端。false：值未加在 Message 末端。

Value0

型別：long

顯示在記錄檔的第一個值。

Value1

型別：long

顯示在記錄檔的第二個值。

Value2

型別：double

顯示在記錄檔的第三個值。

Value3

型別：double

顯示在記錄檔的第四個值。

回傳值

型別：KsError

方法的回傳代碼。

備註

• Category 與 Severity 可用來篩選欲查看的記錄檔，篩選會在 KINGSTAR 記錄檢視 中完成。
• Message 字串使用 UTF-16 編碼。
• 若啟用 AppendValues，輸出的結果為：Message: value0, value1, value2, value3。

可用的 EtherCAT 狀態

ecatOffline, ecatInit, ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

範例

N/A

參見

Api 類別

IntervalZero.KINGSTAR.Local.Api 命名空間