传输清单架构
这些元素构成了 Web 发布和联机打印排序向导传输清单中使用的 XML 架构。
为传输清单定义了以下元素。
- 已取消的页
- 故障页
- 最喜欢的
- 文件
- filelist
- 文件夹
- folderlist
- formdata
- htmlui
- imageproperty
- 元数据
- netplace
- 帖子
- 重设大小
- successpage
- 目标
- transfermanifest
- uploadinfo
cancelledpage
指定在用户单击“取消 ”按钮 关闭向导之前显示的服务器端 HTML 页面。
语法
<cancelledpage
href = "string"
>
<!-- child elements -->
</cancelledpage>
属性
属性 | 描述 |
---|---|
href | 必填。 当用户单击“取消 ”按钮时要显示的服务器端 HTML 页面的 URL。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有 |
failurepage
指定上传未成功时显示的服务器端 HTML 页面。
语法
<failurepage
href = "string"
>
<!-- child elements -->
</failurepage>
属性
属性 | 描述 |
---|---|
href | 必填。 如果上传未成功,则显示服务器端 HTML 页面的 URL。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
喜欢
指示向导在给定 URL 的 收藏夹 菜单中创建收藏夹网站条目。 如果未指定此元素,则将在其位置使用 htmlui 元素。
语法
<favorite
comment = "string"
href = "string"
name = "string"
>
<!-- child elements -->
</favorite>
属性
属性 | 描述 |
---|---|
评论 | 必填。 与 收藏夹 条目关联的注释。 |
href | 必填。 收藏夹 条目的 URL。 |
名字 | 必填。 收藏夹 菜单中显示的 URL 的名称。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
文件
描述要复制的单个文件。 多个 文件 元素可以包含在单个 文件列表 节点下。
语法
<file
contenttype = "string"
destination = "string"
extension = "string"
id = "string"
size = "string"
source = "string"
>
<!-- child elements -->
</file>
属性
属性 | 描述 |
---|---|
contenttype | 自选。 文件的 MIME 类型。 |
目的地 | 必填。 文件上传后建议的路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。 |
外延 | 自选。 文件的文件扩展名。 |
id | 必填。 文件的数字索引。 |
大小 | 自选。 文件的大小(以字节为单位)。 |
源 | 必填。 文件的完整文件系统路径。 |
元素信息
Parent 元素 | 子元素 |
---|---|
filelist | 元数据,发布,调整大小 |
filelist
描述要复制的文件的元素的容器。 多个 文件列表 元素可以包含在单个 transfermanifest 节点下。
语法
<filelist
usesfolders = "1"
>
<!-- child elements -->
</filelist>
属性
属性 | 描述 |
---|---|
usesfolders | 未实现。 |
元素信息
Parent 元素 | 子元素 |
---|---|
transfermanifest | 文件 |
文件夹
描述存储文件的文件夹。 多个 文件夹 元素可以包含在单个 文件夹列表 节点下。
语法
<folder
destination = "string"
>
<!-- child elements -->
</folder>
属性
属性 | 描述 |
---|---|
目的地 | 必填。 上传文件夹后,该文件夹的建议路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。 |
元素信息
Parent 元素 | 子元素 |
---|---|
folderlist | 没有 |
folderlist
描述要复制的文件的元素的容器。 多个 文件夹列表 元素可以包含在单个 transfermanifest 节点下。
语法
<folderlist>
<!-- child elements -->
</folderlist>
属性
没有。
元素信息
Parent 元素 | 子元素 |
---|---|
transfermanifest | 文件夹 |
formdata
描述可能随文件一起传输的可选 HTML 编码表单数据。 如果服务选择将文件上传为多部分文章,则服务会添加此元素。 表单数据以及 post 元素中的信息用于创建帖子标头。
多个 formdata 元素可以包含在单个 uploadinfo 节点下。
语法
<formdata
name = "string"
>
<!-- child elements -->
</formdata>
属性
属性 | 描述 |
---|---|
名字 | 必填。 定义与上传的此部分关联的表单数据名称。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有 |
htmlui
关闭向导时要显示的服务器端 HTML 页面的 URL。 如果缺少 收藏夹 元素并且指定了上传网站的友好名称,则此元素将在 收藏夹 菜单中创建收藏夹网页条目。
语法
<htmlui
href = "string"
>
<!-- child elements -->
</htmlui>
属性
属性 | 描述 |
---|---|
href | 必填。 关闭向导时要显示的服务器端 HTML 页面的 URL。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
imageproperty
指定与文件相关的图像属性。 多个 映像属性 元素可以包含在单个 元数据 节点下。
语法
<imageproperty
id = "string"
>
<!-- child elements -->
</imageproperty>
属性
属性 | 描述 |
---|---|
id | 必填。 特定属性的 ID。 |
元素信息
Parent 元素 | 子元素 |
---|---|
元数据 | 没有。 允许文本。 |
元数据
用于定义特定文件的元数据的元素和文本的容器。 多个 元数据 元素可以包含在单个 文件 节点下。
语法
<metadata>
<!-- child elements -->
</metadata>
属性
没有。
元素信息
Parent 元素 | 子元素 |
---|---|
文件 | imageproperty |
netplace
定义在上传完成后 “我的网络位置” 中创建的网络位置的目标。 可以通过 IPublishingWizard::Initialize 方法阻止创建网络位置。
语法
<netplace
comment = "string"
href = "string"
name = "string"
>
<!-- child elements -->
</netplace>
属性
属性 | 描述 |
---|---|
评论 | 必填。 当光标位于该图标上时,为网络位置图标显示的注释。 |
href | 必填。 网络位置条目的 URL。 |
名字 | 必填。 “我的网络位置” 文件夹中显示的网络位置图标的名称。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
发布
应向其发布文件的 URL。 当传输作为多部分发布完成时,服务会添加此元素,并使用 formdata生成 post 标头。 如果服务选择使用万维网分布式创作和版本控制(WebDAV)执行文件传输,则不应添加此元素。 多个 后 元素可以包含在单个 文件 节点下。
语法
<post
filename = "string"
href = "string"
name = "string"
>
<!-- child elements -->
</post>
属性
属性 | 描述 |
---|---|
文件名 | 自选。 已发布文件的文件名。 |
href | 必填。 目标文件夹的 URL。 |
名字 | 必填。 定义与帖子的此部分关联的表单数据名称。 |
元素信息
Parent 元素 | 子元素 |
---|---|
文件 | 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 是最高的质量。 |
元素信息
Parent 元素 | 子元素 |
---|---|
文件 | 没有。 |
successpage
指定上传成功时显示的服务器端 HTML 页面。
语法
<successpage
href = "string"
>
<!-- child elements -->
</successpage>
属性
属性 | 描述 |
---|---|
href | 必填。 如果上传成功,则显示服务器端 HTML 页面的 URL。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
目标
以通用命名约定(UNC)格式或 WebDAV 服务器指定的目标文件夹。 如果传输使用 WebDAV 或文件系统协议,该服务将添加此目标以指定目标文件夹。 如果服务选择将文件传输作为多部分发布,则不应添加此元素。
语法
<target
href = "string"
>
<!-- child elements -->
</target>
属性
属性 | 描述 |
---|---|
href | 必填。 目标文件夹的 URL。 使用 WebDAV 的 https:// 窗体或用于 UNC 的 \\server\share 窗体。 |
元素信息
Parent 元素 | 子元素 |
---|---|
uploadinfo | 没有。 允许文本。 |
transfermanifest
传输清单文件的父节点。
语法
<transfermanifest>
<!-- child elements -->
</transfermanifest>
属性
没有。
元素信息
Parent 元素 | 子元素 |
---|---|
没有 | filelist、folderlist、uploadinfo |
uploadinfo
用于提供事务中使用的上传站点中信息的元素的容器。 多个 uploadinfo 元素可以包含在单个 transfermanifest 节点下。
语法
<uploadinfo
friendlyname = "string"
>
<!-- child elements -->
</uploadinfo>
属性
属性 | 描述 |
---|---|
friendlyname | 必填。 向导中显示的网站的友好名称。 |
元素信息
Parent 元素 | 子元素 |
---|---|
transfermanifest | 已取消的页、failurepage、收藏夹、htmlui、netplace、successpage、目标 |