ДокументDOM.ВставитьПеред (DOMDocument.InsertBefore)

Синтаксис:

ВставитьПеред(<НовыйУзел>, <Узел>)

Параметры:

<НовыйУзел> (обязательный)

Тип: ДокументDOM.
Вставляемый узел DOM.

<Узел> (обязательный)

Тип: ДокументDOM.
Узел, перед которым необходимо вставить узел, заданный в параметре <НовыйУзел>.
Если параметр не задан, то узел добавляется к концу списка дочерних узлов.

Возвращаемое значение:

Тип: ДокументDOM.

Описание:

Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>.
Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).

Примечание:

Причины вызова исключения:
  • данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного или узел добавляется сам в себя или данный узел Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
  • добавляемый узел был создан документом отличным от создавшего данный узел;
  • данный узел в режиме Только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
  • узел, перед которым осуществляется вставка, не найден.

    

1C:Enterprise Developer's Community