ContentControlBase.ContentUpdating Событие (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
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

Заметки

Элементы управления содержимым можно связать с внедренным в документ фрагментом XML-кода (также называемым пользовательской XML-частью). Дополнительные сведения см. в разделах Элементы управления содержимым и Общие сведения о пользовательских XML-частях.

Событие ContentUpdating происходит только при изменении данных в пользовательской XML-части, когда документ открыт. Это событие не происходит при открытии документа и при изменении данных в пользовательской XML-части, когда документ закрыт.

Дополнительные сведения об обработке событий см. в разделе Прием событий.

Примеры

В приведенном ниже примере кода демонстрируются обработчики событий ContentUpdating и StoreUpdating. В данном примере предполагается, что в документе имеется элемент управления PlainTextContentControl с именем plainTextContentControl1, привязанный к элементу в пользовательской XML-части. Пример кода, в котором демонстрируется привязка элемента управления содержимым к элементу в пользовательской XML-части, см. в разделе Пошаговое руководство. Привязка элементов управления содержимым к пользовательским XML-частям.

Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument. В C# также необходимо присоединить обработчики событий к событиям ContentUpdating и StoreUpdating элемента управления plainTextContentControl1.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.