Общие обозначения
Назначение: 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 для средства миграции пользовательской среды