Método XMLNode.Validate

Artigo
08/01/2011

Valida um indivíduo XMLNode controle contra o esquema XML anexo ou esquemas.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Sub Validate

void Validate()

Comentários

Use o Validate método com o ValidationStatus e ValidationErrorText Propriedades para determinar se um elemento XML é válido de acordo com o esquema aplicado e qual texto de erro para exibir ao usuário. Use o SetValidationError método para substituir as violações de esquema com erros de validação personalizada.

Quando você executa o Validate método, Microsoft Office o Word preenche a XMLSchemaViolations coleção com os nós XML que possuem erros de validação.

Exemplos

O exemplo de código a seguir define o valor de texto de um XMLNode e valida o nó usando a Validate método. O exemplo usa o ValidationStatus propriedade para determinar se o nó é validado. Se o nó não foi validado, o exemplo usa o ValidationErrorText propriedade para exibir a mensagem de erro de validação. Este exemplo assume que o documento atual contém um XMLNode chamado CustomerAddress1Node. Se CustomerAddress1Node tipo de mapas para um elemento de esquema que possui dados de um número inteiro, e a validação irá falhar.

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]);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

XMLNode Interface

Namespace Microsoft.Office.Tools.Word

Partilhar via