XMLNode.Validate 方法

根据附加的一个或多个 XML 架构验证单个 XMLNode 控件。

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Sub Validate

void Validate()

备注

在 Validate 方法中使用 ValidationStatus 和 ValidationErrorText 属性，确定 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 命名空间