Compartilhar via


Convenções gerais

Este artigo descreve as funções auxiliares XML.

Diretrizes gerais XML

Antes de modificar os arquivos .xml , familiarize-se com as seguintes diretrizes:

  • Esquema XML.

    O esquema MigXML.xsdXML da UsMT (User State Migration Tool), pode ser usado para gravar e validar a migração .xml arquivos.

  • Conflitos.

    Em geral, quando há conflitos no esquema XML, o padrão mais específico tem precedência. Para obter mais informações, consulte Conflitos e precedência.

  • Elementos necessários.

    Os elementos necessários para uma migração .xml arquivo são <migração>, <componente>, <função> e <regras>.

  • Elementos filho necessários.

    • O USMT não falhará com um erro se os elementos filho necessários não forem especificados. No entanto, os elementos filho necessários devem ser especificados para que o elemento pai afete a migração.

    • Os elementos filho necessários se aplicam apenas à primeira definição do elemento. Se esses elementos forem definidos e se referirem ao uso do nome, os elementos filho necessários não serão aplicados. Por exemplo, se <detects name="Example"> for definido em <namedElements> e <detects name="Example"/> for especificado no <componente> para se referir a esse elemento, a definição dentro <de namedElements deve ter os elementos filho necessários> , mas o <elemento componente> não precisa ter os elementos filho necessários.

  • Nomes de arquivo com colchetes.

    Se um arquivo que tem um caractere de colchete ([ ou ]) no nome do arquivo estiver sendo migrado, um caractere de carata (^) deverá ser inserido. O caractere de quilate (^) deve estar diretamente antes do colchete para que o caractere de colchete seja válido. Por exemplo, se houver um arquivo chamado .txt, <pattern type="File">c:\documents\mydocs [file^].txt]</pattern> deve ser especificado em vez de <pattern type="File">c:\documents\mydocs [file].txt]</pattern>.

  • Usando aspas.

    Quando o código está cercado entre aspas, podem ser usadas as aspas duplas ("") ou individuais (').

Funções auxiliares

As funções auxiliares XML na biblioteca de elementos XML podem ser usadas para alterar o comportamento de migração. Antes de usar essas funções em um arquivo .xml , observe os seguintes itens:

  • Todos os parâmetros são cadeias de caracteres.

  • Os parâmetros NULL podem ficar em branco.

    Como acontece com parâmetros com uma convenção de valor padrão, se houver um parâmetro NULL no final de uma lista, ele poderá ficar de fora. Por exemplo, a seguinte função:

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

    é equivalente a:

    SomeFunction("My String argument")
    
  • O local codificado usado em todas as funções auxiliares é uma representação de cadeia de caracteres inequívoca para o nome de um objeto.

O local codificado é composto pela parte do nó, opcionalmente seguida pela folha entre colchetes. Esse formato faz uma clara distinção entre nós e folhas.

Por exemplo, especifique o arquivo

C:\Windows\Notepad.exe

para

c:\Windows[Notepad.exe]

Da mesma forma, especifique o diretório

C:\Windows\System32

para

c:\Windows\System32

Observe a ausência dos caracteres [] no segundo exemplo.

O registro é representado de maneira semelhante. O valor padrão de uma chave de registro é representado como um construtor vazio [] . Por exemplo, o valor padrão da chave do HKLM\SOFTWARE\MyKey registro é HKLM\SOFTWARE\MyKey[].

  • Um padrão de localização é especificado de uma forma semelhante à forma como um local real é especificado.

    A exceção é que tanto o nó quanto a parte da folha aceitam padrões. No entanto, um padrão do nó não se estende até a folha.

    Por exemplo, o padrão c:\Windows\\* corresponde ao \Windows diretório e a todos os subdiretórios, mas não corresponde a nenhum dos arquivos nesses diretórios. Para corresponder aos arquivos também, c:\Windows\*[*] deve ser especificado.