XMLNode.ValidationStatus 屬性

取得值，該值可以根據附加的結構描述，指定項目或屬性是否有效。

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

語法

'宣告
ReadOnly Property ValidationStatus As WdXMLValidationStatus
    Get

WdXMLValidationStatus ValidationStatus { get; }

屬性值

型別：Microsoft.Office.Interop.Word.WdXMLValidationStatus
其中一個 WdXMLValidationStatus 值。

備註

ValidationStatus 屬性可以是下列其中一個 WdXMLValidationStatus 值：

• wdXMLValidationStatusCustom 表示 SetValidationError 方法是用來設定 ValidationErrorText 屬性為自訂文字字串。

• 根據附加的結構描述，wdXMLValidationStatusOK 表示 XML 項目或屬性有效。

雖然 ValidationStatus 屬性只允許有兩個命名的常數，但是包含在 Microsoft Office Word 內還有更多來自 MSXML 5.0 元件的值尚未命名。

範例

下列程式碼範例設定 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 命名空間