IDimInstance

Сборка: Dimensions;

Описание

Интерфейс IDimInstance содержит свойства и методы для доступа к данным справочника.

Иерархия наследования

          IDimInstance

Комментарии

Классы объектов репозитория, поддерживающих интерфейс IDimInstance:

Для получения данных справочника необходимо для соответствующего объекта репозитория выполнить метод IMetabaseObjectDescriptor.Open или IMetabaseObjectDescriptor.OpenWithParam и результат выполнения привести к типу IDimInstance.

При работе со справочниками НСИ во время их открытия для элементов будут загружены значения системных атрибутов и атрибутов, используемых в уникальных и неуникальных ключах. Значения пользовательских атрибутов загружаются по мере обращения к ним с помощью свойств и методов интерфейсов IDimAttributesInstance, IDimElements. Используя метод IDimAttributesInstance.EnsureValuesLoaded, можно загрузить значения атрибутов только для определённого набора элементов. Загруженные атрибуты сохраняются в памяти и используются для дальнейшей работы с экземпляром справочника, это позволяет избежать формирования повторных запросов к СУБД.

Если в репозитории включён атрибутный метод разграничения доступа, то при открытии справочников НСИ загружаются значения как системных, так и пользовательских атрибутов, кроме заимствованных атрибутов, атрибутов допускающих множественные значения и отображаемых значений связанных атрибутов.

Более широкие возможности для работы со справочниками НСИ предоставляют интерфейсы IRdsDictionary, IRdsDictionaryInstance.

Свойства

  Имя свойства Краткое описание
Свойство AttributeHierarchies возвращает коллекцию данных альтернативных иерархий справочника.
Свойство Attributes возвращает объект, содержащий коллекцию значений атрибутов справочника.
Свойство Blocks возвращает объект, содержащий коллекцию блоков справочника.
Свойство BuilderException возвращает информацию об ошибке, которая может возникнуть при открытии справочника.
Свойство DefaultElement возвращает индекс элемента по умолчанию.
Свойство Dimension возвращает объект, содержащий структуру справочника.
Свойство Elements возвращает коллекцию элементов экземпляра справочника.
Свойство ElementsByOrder возвращает итератор на дерево элементов справочника, построенное с учетом пользовательской сортировки.
Свойство Ident возвращает идентификатор объекта репозитория, являющегося справочником.
Свойство Indexes возвращает объект, содержащий коллекцию индексов справочника.
InstanceModel

Свойство InstanceModel возвращает общую модель справочника.

Свойство Key возвращает ключ объекта репозитория, являющегося справочником.
Свойство Levels возвращает объект, содержащий коллекцию уровней элементов справочника.
Свойство MetabaseObject возвращает данные справочника, как данные объекта репозитория.
Свойство Name возвращает наименование объекта репозитория, являющегося справочником.
Свойство RootElements возвращает объект, содержащий массив элементов справочника, находящихся на нулевом уровне.

Методы

  Имя метода Краткое описание
Метод CreateSelection создает объект, содержащий отметку справочника.
Метод NewElement создает объект для работы с элементом измерения.
Метод NewElementsOrderSetup возвращает настройки пользовательской сортировки элементов справочника.

См. также:

Интерфейсы сборки Dimensions