本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

XMLNode.SetValidationError 方法 (WdXMLValidationStatus, Object, Boolean)

 

發佈時間: 2016年4月

變更 XMLNode 控制項顯示給使用者的驗證錯誤文字,強制 Microsoft Office Word 將節點回報為無效。

命名空間:   Microsoft.Office.Tools.Word
組件:  Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)

void SetValidationError(
	WdXMLValidationStatus Status,
	ref object ErrorText,
	bool ClearedAutomatically = true
)

參數

Status

其中一個 WdXMLValidationStatus 值指定要設定驗證狀態錯誤文字 (wdXMLValidationStatusCustom) 還是要清除驗證狀態錯誤文字 (wdXMLValidationStatusOK)。

ErrorText

向使用者顯示的文字。  Status 參數設定為 wdXMLValidationStatusOK 時留空白。  

ClearedAutomatically

true 表示在指定的節點上發生下一個驗證事件時,會立刻自動清除錯誤訊息。   false 則表示要求使用 wdXMLValidationStatusOKStatus 參數執行 SetValidationError 方法,清除自訂錯誤文字。  

若要設定自訂錯誤文字,請使用 wdXMLValidationStatusCustom 常數。

如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數

下列程式碼範例使用 SetValidationError 方法,設定 XMLNode 的自訂驗證錯誤訊息。  如果 XMLNode 不會進行驗證,則 ValidationError 事件的事件處理常式會顯示自訂驗證錯誤訊息。  這個範例假設目前文件包含兩個名為 CustomerAddress1NodeCustomerZipNodeXMLNode 物件,這兩個物件會對應到具有整數資料型別的結構描述項目。  

private void XMLNodeValidationError()
{
    // Set custom error message for Address1 element.
    string errorText = this.CustomerAddress1Node.BaseName + 
        " element must be an integer.";
    object objErrorText = (object)errorText;
    this.CustomerAddress1Node.SetValidationError(
        Word.WdXMLValidationStatus.wdXMLValidationStatusCustom,
        ref objErrorText, false);

    // Attach validation event handlers.
    this.CustomerZipNode.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);
    this.CustomerAddress1Node.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);

    // This does not raise a validation error.
    int val = 22222;
    this.CustomerZipNode.NodeText = val.ToString();

    // This raises a validation error.
    this.CustomerAddress1Node.NodeText = 
        "Seventeen Hundred Twenty One";
}

void CustomerNode_ValidationError(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Word.XMLNode tempNode = 
        (Microsoft.Office.Tools.Word.XMLNode)sender;

    MessageBox.Show("Error: " + tempNode.ValidationErrorText[false]);
}
回到頁首
顯示: