Freigeben über


ContentControlBase.ContentUpdating-Ereignis (2007 System)

Aktualisiert: November 2007

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.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Syntax

Public Event ContentUpdating As EventHandler(Of ContentControlContentUpdatingEventArgs)

Dim instance As ContentControlBase
Dim handler As EventHandler(Of ContentControlContentUpdatingEventArgs)

AddHandler instance.ContentUpdating, handler
public event EventHandler<ContentControlContentUpdatingEventArgs> 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 unter Ü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 zur Ereignisbehandlung 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.");
}

Berechtigungen

Siehe auch

Referenz

ContentControlBase-Klasse

ContentControlBase-Member

Microsoft.Office.Tools.Word-Namespace

Weitere Ressourcen

Inhaltssteuerelemente

Übersicht über benutzerdefinierte XML-Abschnitte

Exemplarische Vorgehensweise: Binden von Inhaltssteuerelementen an benutzerdefinierte XML-Abschnitte