通过

一般约定

  • 项目

此主题介绍了 XML Helper 函数。

本主题内容

一般 XML 指南

Helper 函数

一般 XML 指南

修改 .xml 文件之前，先熟悉以下指南：

  • XML 架构

    你可使用 用户状态迁移工具 (USMT) 5.0 XML 架构 MigXML.xsd 写入和验证迁移 .xml 文件。

  • 冲突

    一般而言，当 XML 架构内部存在冲突时，最具体的模式将优先。有关详细信息，请参阅冲突和优先级。

  • 必需元素

    迁移 .xml 文件的必需元素分别是 <migration>、<component>、<role> 以及 <rules>。

  • 必需子元素

    • USMT 如未指定所需的子元素， 将不会失败以及出现错误。但是，你必须指定父元素影响迁移所必需的子元素。

    • 必需的子元素仅适用于元素的第一定义。如果这些元素已定义并引用到使用其名称的情况，则所需的子元素不适用。例如，如果你在 <detects name="Example"> 中定义 <namedElements>，并在 <detects name="Example"/> 中指定 <component> 引用于此元素，则 <namedElements> 内部的定义必须拥有必需的子元素，但 <component> 元素无需拥有必需的子元素。

  • 文件名带有括号

    如果你正在迁移其文件名中带有中括号字符（[ 或 ]）的文件，则必须在中括号字符的括号生效之前，直接插入克拉 (^) 字符。例如，如果存在名为 File.txt 的文件，则必须指定 <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> ，而非 <pattern type="File">c:\documents\mydocs [file].txt]</pattern>。

  • 使用引号

    将代码包含在引号中时，你可以使用双引号 ("") 或单引号 ('')。

Helper 函数

你可使用 XML 元素库中的 XML Helper 函数，更改迁移行为。在使用 .xml 文件中的这些函数之前，请注意以下各项：

  • 所有参数都是字符串

  • 可以将 NULL 参数留空

    对于带有默认值约定的参数，如果你的列表末端有 NULL 参数，则可忽略它。例如，以下函数：

    SomeFunction("My String argument",NULL,NULL)

    等同于：

    SomeFunction("My String argument")

  • 所有帮助程序功能中所用的编码位置是对象名称的清晰字符串表示

    它包含了节点部分，后面可以选择添加方括号括起的叶。这清晰地区分了节点和叶。

    例如，指定文件 C:\Windows\Notepad.exe：c:\Windows[Notepad.exe]。同样地，指定诸如此类的目录 C:\Windows\System32：c:\Windows\System32；注意没有 [] 字符。

    以类似方式表示注册表。注册表项的默认值用空白 [] 结构表示。例如，HKLM\SOFTWARE\MyKey 注册表项的默认值为 HKLM\SOFTWARE\MyKey[]。

  • 按照与指定实际位置的类似方式，指定位置模式

    一个例外是节点和叶都接受模式。但是，来自节点的模式不会扩展到叶。

    例如，模式 c:\Windows\* 将与 \Windows 目录和所有子目录相匹配，但它不与那些目录中的任何文件相匹配。如也要与文件相匹配，则必须指定 c:\Windows\*[*]。

另请参阅

其他资源

USMT XML 参考