XMLNode.Validate 方法

  • 發行項

驗證個別的 XMLNode 控制項是否違反附加的 XML 結構描述或結構描述。

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

語法

'宣告
Sub Validate

void Validate()

備註

根據套用的結構描述以及顯示給使用者的錯誤文字，使用具有 ValidationStatus 和 ValidationErrorText 屬性的 Validate 方法來判斷 XML 項目是否已進行驗證。 使用 SetValidationError 方法來覆寫有自訂驗證錯誤的結構描述違規。

當您執行 Validate 方法時，Microsoft Office Word 會將有驗證錯誤的 XML 節點填入 XMLSchemaViolations 集合。

範例

下列程式碼範例設定 XMLNode 的文字值，並且使用 Validate 方法來驗證節點。 然後範例會使用 ValidationStatus 屬性來判斷節點是否有效。 如果節點沒有驗證，則範例會使用 ValidationErrorText 屬性顯示驗證錯誤訊息。 此範例假設目前的文件包含名為 CustomerAddress1Node 的 XMLNode。 如果 CustomerAddress1Node 對應到有整數資料型別的結構描述項目，則驗證將會失敗。

Private Sub ValidateNode()
    Me.CustomerAddress1Node.NodeText = "Nineteen Hundred"
    Me.CustomerAddress1Node.Validate()

    If Me.CustomerAddress1Node.ValidationStatus = _
        Word.WdXMLValidationStatus.wdXMLValidationStatusOK Then
        MsgBox("'" & Me.CustomerAddress1Node.BaseName & "' validates.")
    Else
        MsgBox("'" & Me.CustomerAddress1Node.BaseName & _
            "': " & Me.CustomerAddress1Node.ValidationErrorText(False))
    End If
End Sub

private void ValidateNode()
{
    this.CustomerAddress1Node.NodeText = "Nineteen Hundred";
    this.CustomerAddress1Node.Validate();

    if (this.CustomerAddress1Node.ValidationStatus ==
        Word.WdXMLValidationStatus.wdXMLValidationStatusOK)
    {
        MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
            "' validates.");
    }
    else
    {
        MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
            "': " + this.CustomerAddress1Node.ValidationErrorText[false]);
    }
}

.NET Framework 安全性

請參閱

參考

XMLNode 介面

Microsoft.Office.Tools.Word 命名空間