ContentControlContentUpdatingEventArgs.Content, propriété

Article
01/06/2014

Obtient ou définit le texte à écrire dans le contrôle de contenu de la partie XML personnalisée liée au contrôle.

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

Syntaxe

'Déclaration
Property Content As String

string Content { get; set; }

Valeur de propriété

Type : System.String
Texte à écrire dans le contrôle de contenu depuis la partie XML personnalisée liée au contrôle.

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. Utilisez la propriété Content pour modifier le texte avant que Microsoft Office Word mette à jour le contrôle.

Pour plus d'informations, consultez Contrôles de contenu et Vue d'ensemble des parties XML personnalisées.

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. Vous pouvez la modifier pour l'exécuter dans un complément d'application. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

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.