Описание

Поменять местами в данной коллекции два объекта.

Определение

Visual Basic
Public Sub Swap( _ ByVal Object1 As Variant, _ ByVal Object2 As Variant _ )

Параметры

Object1: Порядковый номер, ссылка на объект, дескриптор, GUID или описание первого объекта.
Object2: Порядковый номер, ссылка на объект, дескриптор, GUID или описание второго объекта.

Заметки

1. Если коллекция не является составом объекта (TDMSObject.Content или TDMSObject.Objects), а создана виртуальной, действие метода имеет силу только на время выполнения скрипта.

2. Метод выполяет перемещение объекта в локальной копии коллекции, без обращения к базе данных. Для того, чтобы изменения были сохранены, необходимо вызвать метод TDMS~ TDMSObjects~Update (иначе редактирование будет потеряно).

' Правильно:
Set Coll = ThisObject.Content ' Запрошена локальная копия коллекции
Coll.Swap obj1, obj2 ' Переставить объекты
Coll.Update ' Обновить информацию в базе - изменения сохранены.

'Неправильно:
ThisObject.Content.Swap obj1, obj2 'При обращении ThisObject.Content запрашивается коллекция, в ней выполняется перестановка
ThisObject.Content.Update 'Теперь коллекция запрашивается снова и выполняется запрос на обновление
'Все изменения потеряны.

3. Нумерация элементов в коллекции начинается с 0. Для определения максимально допустимой позиции нужно использовать свойство Count.

4. Вызывать метод может только пользователь с правами на редактирование состава объекта-владельца коллекции (если есть).
Исключение: для скриптов при обращении через переменную ThisObject.

Смотри также

TDMSObjects Коллекция | TDMSObjects Члены

Справочное руководство по TDMS 5.0 API
Swap Method
Смотри также Послать замечания