ContentControlStoreUpdatingEventArgs.Content, propriété

Article
08/10/2011

Obtient le texte à enregistrer dans la partie XML personnalisée liée au contrôle de contenu.

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
    Get
    Set

string Content { get; set; }

Valeur de propriété

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

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 la partie XML personnalisée liée au 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 StoreUpdating et ContentUpdating. 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 StoreUpdating et ContentUpdating 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.