传输清单架构

  • 项目

这些元素构成 Web 发布和联机打印订购向导传输清单中使用的 XML 架构。

为传输清单定义了以下元素。

cancelledpage

指定在用户单击“ 取消 ”按钮时关闭向导之前显示的服务器端 HTML 页。

语法

<cancelledpage
    href = "string"
>
<!-- child elements -->
</cancelledpage>

特性

属性 说明
href 必需。 用户单击“ 取消 ”按钮时显示的服务器端 HTML 页的 URL。

 

元素信息

父元素 子元素
uploadinfo 无

 

failurepage

指定要在上传不成功时显示的服务器端 HTML 页。

语法

<failurepage
    href = "string"
>
<!-- child elements -->
</failurepage>

特性

属性 说明
href 必需。 上传不成功时要显示的服务器端 HTML 页的 URL。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

收藏夹

指示向导在给定 URL 的“ 收藏夹 ”菜单中创建收藏的网站条目。 如果未指定此元素，则会在其位置使用 htmlui 元素。

语法

<favorite
    comment = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</favorite>

特性

属性 说明
comment 必需。 与 “收藏夹” 条目关联的注释。
href 必需。 收藏夹条目的 URL。
name 必需。 显示在“收藏夹”菜单中 的 URL 的名称。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

文件

描述要复制的单个文件。 多个 文件 元素可以包含在单个 文件列表 节点下。

语法

<file
    contenttype = "string"
    destination = "string"
    extension = "string"
    id = "string"
    size = "string"
    source = "string"
>
<!-- child elements -->
</file>

特性

属性 说明
contenttype 可选。 文件的 MIME 类型。
destination 必需。 文件上传后的建议路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。
扩展 可选。 文件的文件扩展名。
id 必需。 文件的数字索引。
大小 可选。 文件的大小（字节）。
source 必需。 文件的完整文件系统路径。

 

元素信息

父元素 子元素
filelist metadata， post， resize

 

filelist

描述要复制的文件的元素的容器。 多个 文件列表 元素可以包含在单个 transfermanifest 节点下。

语法

<filelist
    usesfolders = "1"
>
<!-- child elements -->
</filelist>

特性

属性 说明
usesfolders 未实现。

 

元素信息

父元素 子元素
transfermanifest 文件

 

文件夹

描述存储文件的文件夹。 多个 文件夹 元素可以包含在单个 文件夹列表 节点下。

语法

<folder
    destination = "string"
>
<!-- child elements -->
</folder>

特性

属性 描述
destination 必需。 上传后文件夹的建议路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。

 

元素信息

父元素 子元素
folderlist 无

 

folderlist

描述要复制的文件的元素的容器。 多个 folderlist 元素可以包含在单个 transfermanifest 节点下。

语法

<folderlist>
<!-- child elements -->
</folderlist>

特性

无。

元素信息

父元素 子元素
transfermanifest 文件夹

 

formdata

介绍可与文件一起传输的可选 HTML 编码表单数据。 如果服务选择将文件作为多部分文章上传，则会添加此元素。 表单数据以及 post 元素中的信息用于创建帖子标头。

多个 formdata 元素可以包含在单个 uploadinfo 节点下。

语法

<formdata
    name = "string"
>
<!-- child elements -->
</formdata>

特性

属性 说明
name 必需。 定义与上传的此部分关联的表单数据名称。

 

元素信息

父元素 子元素
uploadinfo 无

 

htmlui

关闭向导时要显示的服务器端 HTML 页的 URL。 如果收藏夹元素不存在并且指定了上传网站的友好名称，则此元素会在“ 收藏夹 ”菜单中创建 一个收藏 网页条目。

语法

<htmlui
    href = "string"
>
<!-- child elements -->
</htmlui>

特性

属性 说明
href 必需。 关闭向导时要显示的服务器端 HTML 页的 URL。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

imageproperty

指定与文件相关的图像属性。 单个元数据节点下可以包含多个 imageproperty 元素。

语法

<imageproperty
    id = "string"
>
<!-- child elements -->
</imageproperty>

特性

属性 说明
id 必需。 特定属性的 ID。

 

元素信息

父元素 子元素
metadata 无。 允许使用文本。

 

metadata

用于定义特定文件的元数据的元素和文本的容器。 多个 元数据 元素可以包含在单个 文件 节点下。

语法

<metadata>
<!-- child elements -->
</metadata>

特性

无。

元素信息

父元素 子元素
文件 imageproperty

 

netplace

定义上传完成后在 “我的网络位置”中创建的网络位置 的目标。 可以通过 IPublishingWizard：：Initialize 方法阻止创建网络位置。

语法

<netplace
    comment = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</netplace>

特性

属性 说明
comment 必需。 光标悬停在网络位置图标上时显示的注释。
href 必需。 网络位置条目的 URL。
name 必需。 显示在 “我的网络位置”文件夹中的网络位置 图标的名称。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

post

文件应发布到的 URL。 当传输作为多部分帖子完成时，服务会添加此元素，并使用 formdata 生成帖子标头。 如果服务选择使用万维网分布式创作和版本控制 (WebDAV) 执行文件传输，则不应添加此元素。 单个文件节点下可以包含多个 post 元素。

语法

<post
    filename = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</post>

特性

属性 说明
filename 可选。 已发布文件的文件名。
href 必需。 目标文件夹的 URL。
name 必需。 定义与帖子的此部分关联的表单数据名称。

 

元素信息

父元素 子元素
文件 formdata

 

调整大小

定义图像文件的缩放和重新压缩为 JPEG 格式。 如果源文件已采用 JPEG 格式且小于或等于指定的宽度和高度，则不调整其大小。 如果源文件不是 JPEG 文件，则进行转换。 可以通过 IPublishingWizard：：Initialize 方法阻止文件的缩放、重新压缩和转换。 单个文件节点下可以包含多个调整大小元素。

语法

<resize
    cx = "string"
    cy = "string"
    quality = "string"
>
<!-- child elements -->
</resize>

特性

属性 说明
cx 必需。 上传后图像的宽度（以像素为单位）。 如果此值为 0，则根据 cy 值计算 cx 以保留相对维度。
cy 必需。 上传后图像的高度（以像素为单位）。 如果此值为 0，则根据 cx 值计算 cy 以保留相对维度。
质量 必需。 JPEG 质量值介于 0 和 100 之间，其中 100 是最高质量值。

 

元素信息

父元素 子元素
文件 无。

 

successpage

指定要在上传成功时显示的服务器端 HTML 页。

语法

<successpage
    href = "string"
>
<!-- child elements -->
</successpage>

特性

属性 说明
href 必需。 上传成功时要显示的服务器端 HTML 页的 URL。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

目标

通用命名约定中指定的目标文件夹 (UNC) 格式或 WebDAV 服务器。 如果传输使用 WebDAV 或文件系统协议，则服务会添加此目标以指定目标文件夹。 如果服务选择将文件传输作为多部分后执行，则不应添加此元素。

语法

<target
    href = "string"
>
<!-- child elements -->
</target>

特性

属性 说明
href 必需。 目标文件夹的 URL。 使用 WebDAV 的 https:// 窗体或用于 UNC 的 \\server\share 窗体。

 

元素信息

父元素 子元素
uploadinfo 无。 允许使用文本。

 

transfermanifest

传输清单文件的父节点。

语法

<transfermanifest>
<!-- child elements -->
</transfermanifest>

特性

无。

元素信息

父元素 子元素
无 filelist、 folderlist、 uploadinfo

 

uploadinfo

一个容器，用于提供事务中使用的上传站点中的信息的元素。 单个 transfermanifest 节点下可以包含多个 uploadinfo 元素。

语法

<uploadinfo
    friendlyname = "string"
>
<!-- child elements -->
</uploadinfo>

特性

属性 说明
friendlyname 必需。 向导中显示的网站的友好名称。

 

元素信息

父元素 子元素
transfermanifest cancelledpage， failurepage， favorite， htmlui， netplace， successpage， target