Метод Добавить объекта ОбъектXDTO

[1cwiki]

Раздел

Общие объекты

Подразделы

XDTO

ИмяОбъекта

ОбъектXDTO

ТипСтатьи

Методы

ОбъектXDTO.Добавить (XDTODataObject.Add)
ОбъектXDTO (XDTODataObject)
Добавить (Add)
Вариант синтаксиса: Установка значения нового произвольного свойства
Синтаксис:
Добавить(<Форма>, <URIПространстваИмен>, <ЛокальноеИмя>, <ЭлементДанных>)
Параметры:
<Форма> (обязательный)
Тип: ФормаXML.
Форма XML представления произвольного свойства.
Может принимать значения Элемент или Атрибут.
<URIПространстваИмен> (обязательный)
Тип: Строка.
URI пространства имен XML представления произвольного свойства.
<ЛокальноеИмя> (обязательный)
Тип: Строка.
Локальное имя произвольного свойства.
<ЭлементДанных> (обязательный)
Тип: ЗначениеXDTO; ОбъектXDTO.
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.
Описание варианта метода:
Имя свойства будет создано автоматически, на основе локального имени XML представления свойства.
В случае, если произвольное свойство с полученным именем уже существует и если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.
Тип создаваемого свойства всегда устанавливается anyType пространства имен схемы XML.
Вариант синтаксиса: Установка значения существующего произвольного свойства
Синтаксис:
Добавить(<Имя>, <ЭлементДанных>)
Параметры:
<Имя> (обязательный)
Тип: Строка.
Имя произвольного свойства.
<ЭлементДанных> (обязательный)
Тип: ЗначениеXDTO; ОбъектXDTO.
Элемент данных XDTO (значение или объект), являющийся значением произвольного свойства.
Описание варианта метода:
Если свойства с указанным именем не существует, то будет инициировано исключение.
Если предыдущая установка значения произвольного свойства выполнялась для данного произвольного свойства, либо другого свойства в случае наличия последовательности, - свойство становится списковым с неограниченной верхней границей.
В противном случае будет инициировано исключение.
Описание:
Добавляет значение произвольного свойства.

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