文档到页面转换器配置设置架构

上次修改时间: 2006年8月29日

适用范围: SharePoint Server 2010

文档到页面转换器配置设置架构详细介绍启动文档到页面转换(或者从默认的文档到页面转换界面网页进行,或者通过调用 AddUpdateContentFromSourceDocument 方法以编程方式进行)时传递给转换器的信息。

利用文档到页面转换体系结构,管理员可以根据网站内容类型指定转换器的配置设置。然后将这些配置设置作为该网站内容类型的一部分进行存储,并在您选择转换该内容类型的文档时将这些配置设置传递给转换器。有关详细信息,请参阅转换器设置和内容类型

下面是文档到页面转换器配置设置架构。

<RcaTransformation>
  <ConverterSettings 
    SourceDocLibUrl="serverRelativeDocumentLibraryPath" 
    AllocationLimitHint="maximumFileSizeInBytes">
    …
  </ConverterSettings>

  <TransformationContext>
    …
  </TransformationContext>
</RcaTransformation>

下面是架构中元素的列表及其定义。

  • RcaTransformation   表示文档到页面转换器的特定于内容类型的配置设置和后处理说明。

  • ConverterSettings   表示文档到页面转换器的特定于内容类型的配置设置。ConverterSettings 元素具有以下属性:

    • SourceDocLibUrl   表示源文档库相对于服务器的 URL。提供此信息是为了在要转换的文档包含相对于文档的链接时使用转换器。

    • AllocationLimitHint   表示转换器配置设置中指定的最大文件大小(以字节为单位)。如果未指定文件大小,则不包括此元素。

      提供此信息是为了使转换器能够转换压缩文件格式的文档。强烈建议您的自定义转换器遵守所指定的文件大小限制。

    此外,如果指定配置设置页承载自定义配置设置控件,则 ConverterSettings 元素将包含由该控件生成的 XML。这可以是该控件可以生成且自定义转换器可以分析的任何有效的 XML。有关详细信息,请参阅其他转换器设置控件

  • TransformationContext   表示文档到页面转换体系结构的后处理功能所需的上下文数据。转换器不应访问或更改此信息。

请参阅

概念

使用文档转换器发布页面

其他转换器设置控件

转换器设置和内容类型

文档转换器定义架构