ДокументDOM.ПереименоватьУзел (DOMDocument.RenameNode)

ДокументDOM (DOMDocument)

ПереименоватьУзел (RenameNode)

Синтаксис:

ПереименоватьУзел(<Узел>, <URIПространстваИмен>, <КвалифицированноеИмя>)

Параметры:

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

Тип: АтрибутDOM; ЭлементDOM.
Переименовываемый узел DOM.

<URIПространстваИмен> (обязательный)

Тип: Строка.
URI пространства имен переименовываемого элемента/атрибута.

<КвалифицированноеИмя> (обязательный)

Тип: Строка.
Новое квалифицируемое имя переименовываемого узла.

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

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

Описание:

Переименовывает узлы Элемент и Атрибут.
Выполняется попытка переименования существующего узла, в случае невозможности, создает новый узел с новым именем, префиксом и URI пространства имен и заменяет им исходный узел.

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

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

Примечание:

Причины вызова исключений:

попытка переименования узлов, отличных от Элемент или Атрибут, или в случае, если реализация не поддерживает переименование узлов;
квалифицированное имя содержит символы, недопустимые стандартом XML данного документа;
попытка переименования узла, созданного другим документом DOM;
квалифицированное имя содержит префикс, значение которого недопустимо для данного значения URI пространства имен.

Оглавление | Родительский раздел Платформа 8.3.13.1809