ContentControlBase.ContentUpdating, événement

Article
01/06/2014

Se produit juste avant que Microsoft Office Word mette à jour le texte dans le contrôle de contenu, si ce dernier est lié à une partie XML personnalisée.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Event ContentUpdating As ContentControlContentUpdatingEventHandler

event ContentControlContentUpdatingEventHandler ContentUpdating

Notes

Vous pouvez lier des contrôles de contenu à un élément dans une partie de XML (appelée également partie XML personnalisée) incorporée dans le document. Pour plus d’informations, consultez Contrôles de contenu et Vue d'ensemble des parties XML personnalisées.

L'événement ContentUpdating est déclenché uniquement si les données dans une partie XML personnalisée sont modifiées lorsque le document est ouvert. Cet événement n'est pas déclenché lorsque le document est ouvert et que les données dans une partie XML personnalisée ont été modifiées lorsque le document a été fermé.

Exemples

L'exemple de code suivant illustre les gestionnaires des événements ContentUpdating et StoreUpdating. Cet exemple suppose que le document en cours contient un PlainTextContentControl nommé plainTextContentControl1 qui est lié à un élément dans une partie XML personnalisée. Pour obtenir un exemple de code qui montre comment lier un contrôle de contenu à un élément d'une partie XML personnalisée, consultez Procédure pas à pas : liaison de contrôles de contenu à des parties XML personnalisées.

Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet. En C#, vous devez également attacher les gestionnaires d'événements aux événements ContentUpdating et StoreUpdating de plainTextContentControl1.

Cet exemple illustre une personnalisation au niveau du document.

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.");
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.