Criar novos nós no DOM
A XmlDocument classe tem um método create para todos os tipos de nó. Para criar um nó, forneça ao método um nome, quando necessário, e conteúdo ou outros parâmetros para os nós que têm conteúdo (por exemplo, um nó de texto). Os métodos a seguir precisam de um nome e alguns outros parâmetros preenchidos para criar um nó apropriado:
Outros tipos de nó têm mais requisitos do que apenas fornecer dados para parâmetros.
Para obter informações sobre atributos, consulte Criando novos atributos para elementos no DOM. Para obter informações sobre a validação de nomes de elementos e atributos, consulte Verificação de nome de elemento e atributo XML ao criar novos nós. Para criar referências de entidade, consulte Criando novas referências de entidade. Para obter informações sobre como os namespaces afetam a expansão de referências de entidade, consulte Namespace Affect on Entity Reference Expansion for New Nodes Containing Elements and Attributes.
Uma vez que novos nós são criados, há vários métodos disponíveis para inseri-los na árvore. A tabela lista os métodos com uma descrição de onde o novo nó aparece no DOM (Document Object Model) XML.
Método | Posicionamento do nó |
---|---|
InsertBefore | Inserido antes do nó de referência. Por exemplo, para inserir o novo nó na posição 5:XmlNode refChild = node.ChildNodes[4]; // The reference is zero-based. node.InsertBefore(newChild, refChild); Para obter mais informações, consulte o InsertBefore método. |
InsertAfter | Inserido após o nó de referência. Por exemplo:node.InsertAfter(newChild, refChild); Para obter mais informações, consulte o InsertAfter método. |
AppendChild | Adiciona o nó ao final da lista de nós filho para um determinado nó. Se o nó que está sendo adicionado for um XmlDocumentFragment, todo o conteúdo do fragmento de documento será movido para a lista filho desse nó. Para obter mais informações, consulte o AppendChild método. |
PrependChild | Adiciona o nó ao início da lista de nós filhos de um determinado nó. Se o nó que está sendo adicionado for um XmlDocumentFragment, todo o conteúdo do fragmento de documento será movido para a lista filho desse nó. Para obter mais informações, consulte o PrependChild método. |
Append | Acrescenta um XmlAttribute nó ao final da coleção de atributos associada a um elemento. Para obter mais informações, consulte o Append método. |