Propriedade XMLNode.ValidationStatus

Artigo
08/01/2011

Obtém um valor que especifica se um elemento ou atributo é válido de acordo com o esquema anexado.

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

Sintaxe

'Declaração
ReadOnly Property ValidationStatus As WdXMLValidationStatus
    Get

WdXMLValidationStatus ValidationStatus { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Word.WdXMLValidationStatus
Dentre as WdXMLValidationStatus valores.

Comentários

O ValidationStatus propriedade pode ser uma das seguintes WdXMLValidationStatus valores:

wdXMLValidationStatusCustomindica que o SetValidationError método foi usado para definir o ValidationErrorText propriedade para uma seqüência de caracteres de texto personalizado.
wdXMLValidationStatusOKindica que um elemento ou atributo XML é válido de acordo com o esquema anexado.

Enquanto essas são as constantes nomeadas apenas dois a ValidationStatus permite que a propriedade, há muitos valores mais sem nome, que vêm do componente MSXML 5.0 incluído com o Microsoft Office Word.

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

Compartilhar via