自定义转换设置页

上次修改时间: 2010年3月8日

适用范围: SharePoint Server 2010

您可以指定一个自定义 .aspx 页面(用户可从该页面为所选文档的特定转换指定设置),或者使用 Microsoft SharePoint Foundation 中包含的默认转换设置页面。

若要指定自定义转换设置页面,请将文档转换器定义的 ConverterUIPage 元素设置为您的自定义 aspx 页面的文件名。当用户选择使用您的转换器转换文档时,将显示此页面。设置 ConverterUIPage 元素是可选的。如果您未指定自定义页面,则 Microsoft SharePoint Server 2010 会显示默认页面 DocTrans.aspx。

通过 DocTrans.aspx,用户可以选择要使用的转换器。页面上仅显示使用 DocTrans.aspx 页面的文档转换器。它还使用户能够为每个已转换文件指定文件名,并指定用户是否希望在转换完成时收到通知。提交该页面时,它会为每个所选转换器调用一次 Convert 方法,并传递必要的参数。

DocTrans.aspx 页面指定应异步运行每个转换。

如果您创建了自定义转换设置页面,则您负责包括调用 Convert 方法的代码、传递所有适用的参数。如果某转换器包括自定义配置设置,则该页面必须包括执行以下操作的代码:

  • 确定要转换的文档的内容类型。

  • 访问内容类型定义,检索包含该内容类型的转换器配置设置的 XMLDocument 节点。

  • 将那些转换器配置设置作为 configInfo 参数传递到 Convert 方法。

    备注

    如果您要创建用于发布 Web 内容的文档转换器,则应调用 PublishingPageCollection.Add 方法,而不是 Convert 方法。PublishingPageCollection.Add 方法可提供专门的后处理,该后处理包括创建新的网页、将转换器生成的 HTML 放到该页面上指定的字段中。有关用于发布 Web 内容的文档转换器的详细信息,请参阅使用文档转换器发布页面

您应注意,DocTrans.aspx 页面不执行以下操作:

  • 将任何配置数据传递到 Convert 方法。在创建包括自定义配置设置的文档转换器时,请不要使用 DocTrans.aspx 页面,因为不会将这些设置传递到文档转换器。您应创建自定义转换设置页面,并在文档转换器定义中指定该页面。

  • 指定已转换文件的任何自定义预处理或后处理。有关指定自定义预处理或后处理的详细信息,请参阅已转换文档的自定义处理

请参阅

概念

文档转换器概述

文档转换器

文档转换器部署

文档转换器定义架构

自定义转换器配置设置页

其他转换器设置控件