Аннотации

Аннотации предназначены для получения дополнительной информации через Рефлектор. Поддерживаются два вида аннотаций: для методов и для параметров методов.

Аннотации методов

Объявление:

&Аннотация1
&Аннотация2
Процедура АннотированнаяПроцедура() Экспорт
КонецПроцедуры

Использование с помощью рефлектора:

ТаблицаМетодов = Рефлектор.ПолучитьТаблицуМетодов(Объект);
СтрокаМетода = Рефлектор.Найти("АннотированнаяПроцедура", "Имя");

СтрокаМетода.Аннотации содержит таблицу аннотаций или Неопределено, если аннотации не указаны.

Аннотации параметров методов

Объявление:

Процедура ПроцедураСАннотированнымиПараметрами(
    &Аннотация1ДляПараметра
    &Аннотация2ДляПараметра
    Параметр1,

    &Аннотация1ДляПараметра
    &Аннотация2ДляПараметра
    Параметр2) Экспорт

КонецПроцедуры

Использование с помощью рефлектора:

ТаблицаМетодов = Рефлектор.ПолучитьТаблицуМетодов(Объект);
СтрокаМетода = Рефлектор.Найти("ПроцедураСАннотированнымиПараметрами", "Имя");

ДанныеПараметра1 = СтрокаМетода.Параметры[0];

ДанныеПараметра1.Аннотации содержит таблицу аннотаций или Неопределено, если аннотации не указаны.

Таблица аннотаций

Таблица аннотаций представляет собой таблицу значений с колонками:

  1. Имя, тип Строка
  2. Параметры, тип ТаблицаЗначений. Колонки:
    • Имя, тип Строка или Неопределено
    • Значение, тип Произвольный

Параметры аннотаций

Параметры аннотаций задаются тремя способами:

&Аннотация(ИмяПараметра)

Параметры[0].Имя = "ИмяПараметра", Параметры[0].Значение = Неопределено.

&Аннотация("Значение")

Параметры[0].Имя = Неопределено, Параметры[0].Значение = "Значение".

&Аннотация(ИмяПараметра = 1)

Параметры[0].Имя = "ИмяПараметра", Параметры[0].Значение = 1.

В качестве значения могут использоваться только константные литералы.