ContentControlBase.StoreUpdating 事件

项目
05/20/2013

就在 Microsoft Office Word 更新绑定到内容控件的自定义 XML 部件中的数据之前（即在内容控件中的文本更改之后）发生。

命名空间： Microsoft.Office.Tools.Word
程序集： Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Event StoreUpdating As ContentControlStoreUpdatingEventHandler

event ContentControlStoreUpdatingEventHandler StoreUpdating

备注

可将内容控件绑定到嵌入文档中的某段 XML（也称为“自定义 XML 部件”）内的某个元素。有关更多信息，请参见内容控件和自定义 XML 部件概述。

当内容控件中的文本发生更改，并且内容控件绑定到自定义 XML 部件中的某个元素时，会引发 StoreUpdating 事件。

有关处理事件的更多信息，请参见使用事件。

示例

下面的代码示例演示 StoreUpdating 和 ContentUpdating 事件的事件处理程序。此示例假定文档中包含一个名为 plainTextContentControl1 的 PlainTextContentControl，且该控件绑定到某个自定义 XML 部件中的元素。有关演示如何将内容控件绑定到自定义 XML 部件中的元素的代码示例，请参见演练：将内容控件绑定到自定义 XML 部件。

若要使用此代码，请将其粘贴到项目内的 ThisDocument 类中。对于 C#，还必须将这两个事件处理程序附加到 plainTextContentControl1 的 StoreUpdating 和 ContentUpdating 事件。

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