Evento ContentControlBase.StoreUpdating

Articolo
08/11/2011

Si verifica poco prima che Microsoft Office Word aggiorni i dati in una web part XML personalizzata associata al controllo contenuto, vale a dire dopo la modifica del testo nel controllo contenuto.

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

Sintassi

'Dichiarazione
Event StoreUpdating As ContentControlStoreUpdatingEventHandler

event ContentControlStoreUpdatingEventHandler StoreUpdating

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 StoreUpdating viene generato in caso di modifica del testo in un controllo contenuto associato a un elemento in una web part XML personalizzata.

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 StoreUpdating e ContentUpdating. 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 StoreUpdating e ContentUpdating di plainTextContentControl1.

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.