Errors.Add 方法
將 ErrorObject 物件新增到 ErrorsCollection，並傳回新 Error 物件的參考。
**命名空間：**Microsoft.Office.Interop.InfoPath
**組件：**Microsoft.Office.Interop.InfoPath (於 microsoft.office.interop.infopath.dll 中)
語法
'宣告
<DispIdAttribute(2)> _
Function Add ( _
<InAttribute> varNode As Object, _
<InAttribute> bstrConditionName As String, _
<InAttribute> bstrShortErrorMessage As String, _
<InAttribute> <OptionalAttribute> Optional bstrDetailedErrorMessage As String = "", _
<InAttribute> <OptionalAttribute> Optional lErrorCode As Integer = 0, _
<InAttribute> <OptionalAttribute> Optional bstrType As String = "modeless" _
) As ErrorObject
'用途
Dim instance As Errors
Dim varNode As Object
Dim bstrConditionName As String
Dim bstrShortErrorMessage As String
Dim bstrDetailedErrorMessage As String
Dim lErrorCode As Integer
Dim bstrType As String
Dim returnValue As ErrorObject
returnValue = instance.Add(varNode, bstrConditionName, bstrShortErrorMessage, bstrDetailedErrorMessage, lErrorCode, bstrType)
[DispIdAttribute(2)]
ErrorObject Add (
[InAttribute] Object varNode,
[InAttribute] string bstrConditionName,
[InAttribute] string bstrShortErrorMessage,
[OptionalAttribute] [InAttribute] string bstrDetailedErrorMessage,
[OptionalAttribute] [InAttribute] int lErrorCode,
[OptionalAttribute] [InAttribute] string bstrType
)
參數
- varNode
將會與錯誤關聯的 XML 節點。
- bstrConditionName
錯誤的名稱。
- bstrShortErrorMessage
錯誤的簡短訊息。
- bstrDetailedErrorMessage
錯誤的詳細訊息。
- lErrorCode
錯誤的錯誤碼。
- bstrType
預設值為 "modeless"。錯誤處理類型。另一個支援的值為 "modal"。
傳回值
代表新建立 Error 的 ErrorObject 物件。
備註
Add 方法可以用於在 Microsoft Office InfoPath 2007 表單中建立自訂錯誤訊息。使用 Add 方法可建立兩種錯誤類型：
modeless |
使用內嵌提醒通知使用者發生錯誤，且使用者可以選擇使用復原作業還原至先前的值。 |
modal |
使用對話方塊提醒通知使用者發生錯誤。在按一下對話方塊提醒中的 [確定] 後，錯誤會顯示成內嵌提醒，且使用者可以選擇使用復原作業還原至先前的值。 |
注意
也可以使用 ReportError 方法建立自訂錯誤。
範例
//Add an error to the node
IXMLDOMDocument myDOM = thisXDocument.DOM;
IXMLDOMNode myNode = myDOM.selectSingleNode("my:myFields/my:aGroup/my:field1");
thisXDocument.Errors.Add(myNode,"condition","short","detail",102057,"modeless");