演练：在应用程序级项目中绑定到服务中的数据

项目
08/12/2011

可以将数据绑定到应用程序级项目中的宿主控件。本演练演示如何在运行时将控件添加到 Microsoft Office Word 文档中、将控件绑定到从 MSDN Content Service 检索到的数据以及响应事件。

**适用于：**本主题中的信息适用于 Word 2007 和 Word 2010 的应用程序级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

本演练阐释了以下任务：

在运行时将 RichTextContentControl 控件添加到文档中。
将 RichTextContentControl 控件绑定到 Web 服务中的数据。
响应 RichTextContentControl 控件的 Entering 事件。

提示

对于在以下说明中使用的某些 Visual Studio 用户界面元素，您的计算机可能会显示不同的名称或位置。这些元素取决于您所使用的 Visual Studio 版本和您所使用的设置。有关更多信息，请参见 Visual Studio 设置。

系统必备

您需要以下组件来完成本演练：

Visual Studio 2010 的一个版本，其中包含 Microsoft Office 开发工具。有关更多信息，请参见[将计算机配置为开发 Office 解决方案](bb398242\(v=vs.100\).md)。

Microsoft Office Word 2007 或 Word 2010。

创建新项目

第一步是创建 Word 外接程序项目。

创建新项目

使用 Visual Basic 或 C# 创建一个名为“MTPS Content Service”的 Word 外接程序项目。

有关更多信息，请参见如何：在 Visual Studio 中创建 Office 项目。

Visual Studio 会打开 ThisAddIn.vb 或 ThisAddIn.cs 文件并将项目添加到**“解决方案资源管理器”**中。

添加 Web 服务

对于本演练，请使用称为 MTPS Content Service 的 Web 服务。此 Web 服务以 XML 字符串或纯文本的形式返回指定 MSDN 文章中的信息。下一步演示如何在内容控件中显示返回的信息。

将 MTPS Content Service 添加到项目中

在**“数据”菜单上，单击“添加新数据源”**。
在**“数据源配置向导”中单击“服务”，再单击“下一步”**。
在**“地址”**字段中键入下面的 URL：

http://services.msdn.microsoft.com/ContentServices/ContentService.asmx
单击**“转到”**。
在**“命名空间”字段中键入 ContentService，再单击“确定”**。
在**“添加引用向导”对话框中单击“完成”**。

在运行时添加内容控件并绑定到数据

在应用程序级项目中，在运行时添加和绑定控件。对于本演练，请将内容控件配置为当用户在内容控件内单击时检索 Web 服务中的数据。

添加内容控件并绑定到数据

在 ThisAddIn 类中，分别为 MTPS Content Service、内容控件和数据绑定声明变量。

Private request As ContentService.getContentRequest
Private proxy As ContentService.ContentServicePortTypeClient
Private document As ContentService.requestedDocument()
Private response As ContentService.getContentResponse
Private appId As ContentService.appId
Private WithEvents richTextContentControl As Microsoft.Office.Tools.Word.RichTextContentControl
Private components As System.ComponentModel.Container
Private primaryDocumentsBindingSource As System.Windows.Forms.BindingSource

private ContentService.getContentRequest request;
private ContentService.ContentServicePortTypeClient proxy;
private ContentService.requestedDocument[] document;
private ContentService.getContentResponse response;
private ContentService.appId appId;
private Microsoft.Office.Tools.Word.RichTextContentControl richTextContentControl;
private System.ComponentModel.Container components;
private System.Windows.Forms.BindingSource primaryDocumentsBindingSource;

将下面的方法添加到 ThisAddIn 类中。此方法会在活动文档的开始处创建一个内容控件。

Private Sub AddRichTextControlAtRange()

    Dim currentDocument As Word.Document = Me.Application.ActiveDocument
    currentDocument.Paragraphs(1).Range.InsertParagraphBefore()

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim extendedDocument As Document = Globals.Factory.GetVstoObject(currentDocument)

    ' In projects that target the .NET Framework 3.5, use the following line of code instead.
    ' Dim extendedDocument As Document = currentDocument.GetVstoObject()

    richTextContentControl = extendedDocument.Controls.AddRichTextContentControl _
        (currentDocument.Paragraphs(1).Range, "richTextControl2")
    richTextContentControl.PlaceholderText = _
        "Click here to download MSDN Library information about content controls."
End Sub

private void AddRichTextControlAtRange()
{
    Word.Document currentDocument = this.Application.ActiveDocument;
    currentDocument.Paragraphs[1].Range.InsertParagraphBefore();

    // Use the following line of code in projects that target the .NET Framework 4.
    Document extendedDocument = Globals.Factory.GetVstoObject(currentDocument);

    // In projects that target the .NET Framework 3.5, use the following line of code instead.
    // Document extendedDocument = currentDocument.GetVstoObject();

    richTextContentControl = extendedDocument.Controls.AddRichTextContentControl(
        currentDocument.Paragraphs[1].Range, "richTextContentControl");
    richTextContentControl.PlaceholderText =
        "Click here to download MSDN Library information about content controls.";
}

将下面的方法添加到 ThisAddIn 类中。此方法会初始化需要创建的对象并向 Web 服务发送一个请求。

Private Sub InitializeServiceObjects()
    request = New ContentService.getContentRequest()
    proxy = New ContentService.ContentServicePortTypeClient()
    document = New ContentService.requestedDocument(0) {}
    response = New ContentService.getContentResponse()
    appId = New ContentService.appId()
    components = New System.ComponentModel.Container()
    primaryDocumentsBindingSource = New System.Windows.Forms.BindingSource(components)
End Sub

private void InitializeServiceObjects()
{
    request = new ContentService.getContentRequest();
    proxy = new ContentService.ContentServicePortTypeClient();
    document = new ContentService.requestedDocument[1];
    response = new ContentService.getContentResponse();
    appId = new ContentService.appId();
    components = new System.ComponentModel.Container();
    primaryDocumentsBindingSource = new System.Windows.Forms.BindingSource(this.components);
}

创建一个事件处理程序，当用户在内容控件内单击时检索有关内容控件的 MSDN Library 文档，并将数据绑定到内容控件。

Private Sub richTextContentControl_Entering _
    (ByVal sender As Object, ByVal e As ContentControlEnteringEventArgs) _
    Handles richTextContentControl.Entering

    document(0) = New ContentService.requestedDocument()
    With document(0)
        .type = ContentService.documentTypes.primary
        .selector = "Mtps.Xhtml"
    End With

    With request
        .contentIdentifier = "ed59e522-dd6e-4c82-8d49-f5dbcfcc950d"
        .locale = "en-us"
        .version = "VS.90"
        .requestedDocuments = document
    End With

    response = proxy.GetContent(appId, request)

    primaryDocumentsBindingSource.DataSource = _
        response.primaryDocuments(0).Any.InnerText
    richTextContentControl.DataBindings.Add("Text", _
        primaryDocumentsBindingSource.DataSource, "", True, _
        System.Windows.Forms.DataSourceUpdateMode.OnValidation)
End Sub

void richTextContentControl_Entering(object sender, ContentControlEnteringEventArgs e)
{
    document[0] = new ContentService.requestedDocument();
    document[0].type = ContentService.documentTypes.primary;
    document[0].selector = "Mtps.Xhtml";

    request.contentIdentifier = "ed59e522-dd6e-4c82-8d49-f5dbcfcc950d";
    request.locale = "en-us";
    request.version = "VS.90";
    request.requestedDocuments = document;

    response = proxy.GetContent(appId, request);
    primaryDocumentsBindingSource.DataSource =
        response.primaryDocuments[0].Any.InnerText;
    richTextContentControl.DataBindings.Add("Text",
        primaryDocumentsBindingSource.DataSource, "", true,
        System.Windows.Forms.DataSourceUpdateMode.OnValidation);
}

从 ThisAddIn_Startup 方法调用 AddRichTextControlAtRange 和 InitializeServiceObjects 方法。对于 C# 程序员，添加一个事件处理程序。

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    AddRichTextControlAtRange()
    InitializeServiceObjects()
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    AddRichTextControlAtRange();
    InitializeServiceObjects();
    this.richTextContentControl.Entering += richTextContentControl_Entering;
}

测试外接程序

打开 Word 后，RichTextContentControl 控件会随即显示。当在该控件内单击时，该控件中的文本会发生变化。

测试外接程序

按 F5。
在内容控件内单击。

随即从 MTPS Content Service 下载信息并将信息显示在内容控件中。

请参见

其他资源

将数据绑定到 Office 解决方案中的控件

通过

演练：在应用程序级项目中绑定到服务中的数据

系统必备

创建新项目

创建新项目

添加 Web 服务

将 MTPS Content Service 添加到项目中

在运行时添加内容控件并绑定到数据

添加内容控件并绑定到数据

测试外接程序

测试外接程序

请参见

其他资源

其他资源