Evento ContentControlBase.ContentUpdating

Articolo
05/17/2013

Si verifica poco prima che Microsoft Office Word aggiorni automaticamente il testo di un controllo contenuto associato a una web part XML personalizzata.

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

Sintassi

'Dichiarazione
Event ContentUpdating As ContentControlContentUpdatingEventHandler

event ContentControlContentUpdatingEventHandler ContentUpdating

Note

È possibile associare i controlli contenuto a un elemento in una porzione di codice XML, anche detta web part XML personalizzata, incorporata nel documento.Per ulteriori informazioni, vedere Controlli del contenuto e Cenni preliminari sulle web part XML personalizzate.

L'evento ContentUpdating viene generato soltanto in caso di modifica dei dati contenuti in una web part XML personalizzata all'apertura del documento.Non viene generato se i dati contenuti in una web part XML personalizzata sono stati modificati alla chiusura del documento che viene aperto.

Per ulteriori informazioni sulla gestione degli eventi, vedere Utilizzo degli eventi.

Esempi

Nell'esempio di codice riportato di seguito vengono illustrati i gestori eventi per gli eventi ContentUpdating e StoreUpdating.In questo esempio si presuppone che nel documento sia contenuto un oggetto PlainTextContentControl denominato plainTextContentControl1 associato a un elemento di una Web part XML personalizzata.Per un esempio di codice in cui viene illustrato come associare un controllo del contenuto a un elemento di una Web part XML personalizzata, vedere Procedura dettagliata: associazione dei controlli del contenuto a parti XML personalizzate.

Per utilizzare il codice, incollarlo nella classe ThisDocument del progetto.In C# è inoltre necessario collegare i gestori eventi agli eventi ContentUpdating e StoreUpdating di plainTextContentControl1.

Questo esempio è valido per una personalizzazione a livello di documento.

Private Sub plainTextContentControl1_StoreUpdating(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContentControlStoreUpdatingEventArgs) _
    Handles PlainTextContentControl1.StoreUpdating

    MessageBox.Show("The control was changed to the following value: " & vbCrLf & _
        e.Content & vbCrLf & "This value is about to be written to the node that is bound to this control.")
End Sub

Private Sub plainTextContentControl1_ContentUpdating(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContentControlContentUpdatingEventArgs) _
    Handles PlainTextContentControl1.ContentUpdating

    MessageBox.Show("The node that is bound to this control was changed to the following value: " & vbCrLf & _
        e.Content & vbCrLf & "This value is about to be written to this control.")
End Sub

void plainTextContentControl1_StoreUpdating(object sender, 
    Microsoft.Office.Tools.Word.ContentControlStoreUpdatingEventArgs e)
{
    MessageBox.Show("The control was changed to the following value: \n\n" +
        e.Content + "\n\nThis value is about to be written to the node that is bound to this control.");
}

void plainTextContentControl1_ContentUpdating(object sender, 
    Microsoft.Office.Tools.Word.ContentControlContentUpdatingEventArgs e)
{
    MessageBox.Show("The node that is bound to this control was changed to the following value: \n\n" +
        e.Content + "\n\nThis value is about to be written to this control.");
}

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.