ContentControlBase.ContentUpdating-Ereignis

Artikel
08/10/2011

Tritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Event ContentUpdating As ContentControlContentUpdatingEventHandler

event ContentControlContentUpdatingEventHandler ContentUpdating

Hinweise

Sie können Inhaltssteuerelemente an ein Element in einem Teil von XML-Code (auch benutzerdefinierter XML-Abschnitt genannt) binden, der im Dokument eingebettet ist. Weitere Informationen finden Sie unter Inhaltssteuerelemente und Übersicht über benutzerdefinierte XML-Abschnitte.

Das ContentUpdating-Ereignis wird nur ausgelöst, wenn die Daten eines XML-Abschnitts geändert werden, während das Dokument geöffnet ist. Dieses Ereignis wird nicht ausgelöst, wenn das Dokument geöffnet wird und die Daten in einem benutzerdefinierten XML-Abschnitt geändert wurden, als das Dokument geschlossen wurde.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Codebeispiel werden Ereignishandler für das ContentUpdating-Ereignis und das StoreUpdating-Ereignis dargestellt. In diesem Beispiel wird davon ausgegangen, dass das Dokument ein PlainTextContentControl mit dem Namen plainTextContentControl1 enthält, das an ein Element in einem benutzerdefinierten XML-Abschnitt gebunden ist. Ein Codebeispiel, das die Bindung eines Inhaltssteuerelements an ein Element in einem benutzerdefinierten XML-Abschnitt veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Binden von Inhaltssteuerelementen an benutzerdefinierte XML-Abschnitte.

Wenn Sie diesen Code verwenden möchten, fügen Sie ihn in der ThisDocument-Klasse im Projekt ein. In C# müssen Sie außerdem die Ereignishandler an das ContentUpdating-Ereignis und das StoreUpdating-Ereignis von plainTextContentControl1 anfügen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.