ОбъектXDTO.Добавить (XDTODataObject.Add)

Вариант синтаксиса: Установка значения нового произвольного свойства

Синтаксис:

Добавить(<Форма>, <URIПространстваИмен>, <ЛокальноеИмя>, <ЭлементДанных>)

Параметры:

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

Тип: ФормаXML.
Форма XML представления произвольного свойства.
Может принимать значения Элемент или Атрибут.

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

Тип: Строка.
URI пространства имен XML представления произвольного свойства.

<ЛокальноеИмя> (обязательный)

Тип: Строка.
Локальное имя произвольного свойства.

<ЭлементДанных> (обязательный)

Тип: ЗначениеXDTO; ОбъектXDTO.
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.

Описание варианта метода:

Имя свойства будет создано автоматически, на основе локального имени XML представления свойства.
В случае, если произвольное свойство с полученным именем уже существует и если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.
Тип создаваемого свойства всегда устанавливается anyType пространства имен схемы XML.

Вариант синтаксиса: Установка значения существующего произвольного свойства

Синтаксис:

Добавить(<Имя>, <ЭлементДанных>)

Параметры:

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

Тип: Строка.
Имя произвольного свойства.

<ЭлементДанных> (обязательный)

Тип: ЗначениеXDTO; ОбъектXDTO.
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.

Описание варианта метода:

Если свойства с указанным именем не существует, то будет инициировано исключение.
Если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, - свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.

Описание:

Добавляет значение произвольного свойства.

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

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

Примечание:

Вызов метода может быть осуществлен только для объектов типов с установленным свойством Открытый, в противном случае будет инициировано исключение.

    

1C:Enterprise Developer's Community