Metodo XMLNode.Validate

Articolo
08/11/2011

Convalida un singolo controllo XMLNode in base allo schema o agli schemi XML collegati.

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

Sintassi

'Dichiarazione
Sub Validate

void Validate()

Note

Per determinare se un elemento XML è valido in base allo schema applicato e il tipo di testo di errore da visualizzare all'utente, utilizzare il metodo Validate con le proprietà ValidationStatus e ValidationErrorText. Per eseguire l'override delle violazioni di schema con errori di convalida personalizzati, utilizzare il metodo SetValidationError.

Quando viene eseguito il metodo Validate, Microsoft Office Word compila l'insieme XMLSchemaViolations con i nodi XML che presentano errori di convalida.

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