IDimInstance

Сборка: Dimensions;

Описание

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

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

          IDimInstance

Комментарии

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

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

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

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

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

Свойства

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

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

Методы

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

См. также:

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