XMLNode.Validate - метод

Статья
08/11/2011

Проверяет отдельный элемент управления XMLNode на соответствие прикрепленной схеме (схемам) XML.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
Sub Validate

void Validate()

Заметки

Чтобы определить, является ли элемент XML допустимым в соответствии с примененной схемой, и указать выводимый пользователю текст сообщения об ошибке, воспользуйтесь методом Validate со свойствами ValidationStatus и ValidationErrorText. Чтобы заменить сообщения об ошибках схемы на собственные, воспользуйтесь методом SetValidationError.

При вызове метода Validate приложение Microsoft Office Word вносит в коллекцию XMLSchemaViolations узлы XML с ошибками проверки.

Примеры

В приведенном ниже примере кода задается текстовое значение объекта XMLNode и выполняется проверка этого узла с помощью метода Validate. После этого, обратившись к свойству ValidationStatus, код данного примера определяет, была ли произведена проверка узла. Если результат проверки узла оказался негативным, в данном примере для отображения сообщения об ошибке проверки используется свойство ValidationErrorText. В данном примере предполагается, что текущий документ содержит узел XMLNode с именем CustomerAddress1Node. Если 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 - пространство имен

Поделиться через