Propriedade XMLNode.ValidationErrorText

Artigo
08/01/2011

Obtém uma seqüência de caracteres que representa a descrição de um erro de validação em um XMLNode de controle.

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

Sintaxe

'Declaração
ReadOnly Property ValidationErrorText As XMLNode_ValidationErrorTextType
    Get

XMLNode_ValidationErrorTextType ValidationErrorText { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Word.XMLNode_ValidationErrorTextType
Uma seqüência de caracteres que representa a descrição de um erro de validação em um XMLNode de controle.

Comentários

O ValidationErrorText propriedade destina-se a ser usado com o parâmetro a seguir.

Parameter	Description
Advanced	truePara exibir a versão avançada da descrição do erro de validação, proveniente do componente MSXML 5.0 incluído com o Word de Microsoft Office; Caso contrário, false.

Se você usar o ValidationErrorText a propriedade sem especificar um parâmetro, ele retorna um XMLNode_ValidationErrorTextType objeto que não se destina a ser usado diretamente em seu código.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

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