ContentControlContentUpdatingEventArgs.Content 属性

项目
05/20/2013

获取或设置正在从绑定到控件的自定义 XML 部件写入内容控件的文本。

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

语法

声明
Property Content As String

string Content { get; set; }

属性值

类型：System.String
正在从绑定到控件的自定义 XML 部件写入内容控件的文本。

备注

可将内容控件绑定到嵌入文档中的某段 XML（也称为“自定义 XML 部件”）内的某个元素。使用 Content 属性可在 Microsoft Office Word 更新控件之前更改文本。

有关更多信息，请参见内容控件和自定义 XML 部件概述。

示例

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

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

此示例针对的是文档级自定义项。您可以修改此示例，以使其在应用程序级外接程序中运行。有关更多信息，请参见在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

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