Metodo XMLNode.SetValidationError

Articolo
08/11/2011

Modifica il testo dell'errore di convalida visualizzato all'utente per un controllo XMLNode e impone la segnalazione della non validità di un nodo da parte di Microsoft Office Word.

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

Sintassi

'Dichiarazione
Sub SetValidationError ( _
    Status As WdXMLValidationStatus, _
    ByRef ErrorText As Object, _
    ClearedAutomatically As Boolean _
)

void SetValidationError(
    WdXMLValidationStatus Status,
    ref Object ErrorText,
    bool ClearedAutomatically
)

Parametri

Status
Tipo: Microsoft.Office.Interop.Word.WdXMLValidationStatus
Uno dei valori WdXMLValidationStatus che specifica se impostare il testo di errore dello stato di convalida (wdXMLValidationStatusCustom) o se cancellarlo (wdXMLValidationStatusOK).

ErrorText
Tipo: System.Object%
Testo visualizzato all'utente.Lasciare vuoto quando il parametro Status è impostato su wdXMLValidationStatusOK.

ClearedAutomatically
Tipo: System.Boolean
true per cancellare automaticamente il messaggio di errore non appena si verifica il successivo evento di convalida nel nodo specificato.false per richiedere l'esecuzione del metodo SetValidationError con un parametro Status dell'oggetto wdXMLValidationStatusOK per cancellare il testo di errore personalizzato.

Note

Per impostare un testo di errore personalizzato, utilizzare la costante wdXMLValidationStatusCustom.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene utilizzato il metodo SetValidationError per impostare un messaggio di errore di convalida personalizzato per un oggetto XMLNode. Il messaggio di errore di convalida personalizzato viene visualizzato da un gestore eventi relativo all'evento ValidationError se l'oggetto XMLNode non esegue la convalida. In questo esempio si suppone che il documento corrente contenga due oggetti XMLNode denominati CustomerAddress1Node e CustomerZipNode, mappati agli elementi dello schema con un tipo di dati integer.

Private Sub XMLNodeValidationError()

    ' Set custom error message for Address1 element.
    Dim errorText As String = Me.CustomerAddress1Node.BaseName & _
        " element must be an integer."
    Dim objErrorText As Object = CType(errorText, Object)
    Me.CustomerAddress1Node.SetValidationError( _
        Word.WdXMLValidationStatus.wdXMLValidationStatusCustom, _
        objErrorText, False)

    ' This does not raise a validation error.
    Dim val As Integer = 22222
    Me.CustomerZipNode.NodeText = val.ToString()

    ' This raises a validation error.
    Me.CustomerAddress1Node.NodeText = "Seventeen Hundred Twenty One"
End Sub

Private Sub CustomerNode_ValidationError(ByVal sender As Object, _
    ByVal e As EventArgs) Handles CustomerZipNode.ValidationError, _
    CustomerAddress1Node.ValidationError

    Dim tempNode As Microsoft.Office.Tools.Word.XMLNode = CType(sender,  _
        Microsoft.Office.Tools.Word.XMLNode)
    MsgBox("Error: " & tempNode.ValidationErrorText(False))
End Sub

private void XMLNodeValidationError()
{
    // Set custom error message for Address1 element.
    string errorText = this.CustomerAddress1Node.BaseName + 
        " element must be an integer.";
    object objErrorText = (object)errorText;
    this.CustomerAddress1Node.SetValidationError(
        Word.WdXMLValidationStatus.wdXMLValidationStatusCustom,
        ref objErrorText, false);

    // Attach validation event handlers.
    this.CustomerZipNode.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);
    this.CustomerAddress1Node.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);

    // This does not raise a validation error.
    int val = 22222;
    this.CustomerZipNode.NodeText = val.ToString();

    // This raises a validation error.
    this.CustomerAddress1Node.NodeText = 
        "Seventeen Hundred Twenty One";
}

void CustomerNode_ValidationError(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Word.XMLNode tempNode = 
        (Microsoft.Office.Tools.Word.XMLNode)sender;

    MessageBox.Show("Error: " + tempNode.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