Proprietà XMLNode.ValidationStatus

Articolo
08/11/2011

Ottiene un valore che specifica se un elemento o un attributo è valido in base allo schema collegato.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
ReadOnly Property ValidationStatus As WdXMLValidationStatus
    Get

WdXMLValidationStatus ValidationStatus { get; }

Valore proprietà

Tipo: Microsoft.Office.Interop.Word.WdXMLValidationStatus
Uno dei valori WdXMLValidationStatus.

Note

La proprietà ValidationStatus può essere uno dei valori della proprietà WdXMLValidationStatus seguenti:

L'oggetto wdXMLValidationStatusCustom indica che il metodo SetValidationError è stato utilizzato per impostare la proprietà ValidationErrorText su una stringa di testo personalizzata.
L'oggetto wdXMLValidationStatusOK indica che un attributo o elemento XML è valido in base allo schema collegato.

Se queste rappresentano le due uniche costanti denominate consentite dalla proprietà ValidationStatus, esistono molti altri valori senza nome che provengono dal componente MSXML 5.0 fornito con Microsoft Office Word.

Esempi

Nell'esempio di codice seguente viene impostato il valore di testo di un oggetto XMLNode e viene eseguita la convalida del nodo mediante il metodo Validate. Viene quindi utilizzata la proprietà ValidationStatus per determinare se il nodo è stato convalidato. Se il nodo non è stato convalidato, verrà utilizzata la proprietà ValidationErrorText per visualizzare il messaggio di errore di convalida. In questo esempio si suppone che il documento corrente contenga un oggetto XMLNode denominato CustomerAddress1Node. Se l'oggetto CustomerAddress1Node viene associato a un elemento dello schema che presenta un tipo di dati integer, la convalida avrà esito negativo.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

XMLNode Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite