Общие обозначения

  • Статья

Назначение: Windows 7, Windows 8, Windows 8.1, Windows Vista

В этом разделе описываются вспомогательные функции XML.

В этом разделе

Общие рекомендации по XML

Вспомогательные функции

Общие рекомендации по XML

Перед изменением XML-файлов ознакомьтесь со следующими рекомендациями.

  • Схема XML

    Вы можете использовать схему XML Средство миграции пользовательской среды 5.0 (MigXML.xsd) для создания и проверки XML-файлов переноса.

  • Конфликты

    Как правило, если в схеме XML возникают конфликты, приоритет отдается самому частному шаблону. Дополнительные сведения см. в разделе Конфликты и приоритеты.

  • Необходимые элементы

    Для XML-файла переноса необходимы элементы <migration>, <component>, <role> и <rules>.

  • Обязательные дочерние элементы

    • Средство миграции пользовательской среды не завершится ошибкой, если вы не укажете необходимые дочерние элементы. Однако чтобы родительский элемент повлиял на перенос, требуется указать необходимые дочерние элементы.

    • Необходимые дочерние элементы применяются только к первому определению элемента. Если эти элементы уже определены и затем на них ссылаются по имени, то необходимые дочерние элементы не применяются. Например, если вы определяете <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>.

  • Использование кавычек

    Чтобы заключить код в кавычки, можно использовать двойные ("") или одинарные ('') кавычки.

Вспомогательные функции

Чтобы изменить поведение переноса, можно воспользоваться вспомогательными функциями XML из Библиотека XML-элементов. Прежде чем использовать эти функции в 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\*[*].

См. также

Другие ресурсы

Справочные материалы по XML для средства миграции пользовательской среды