ILogonSession.Credentials

Синтаксис

Credentials(Realm: String; [ToAdmin: Boolean = False]): ICredentials;

Параметры

Realm. Область действия учётных данных. В качестве значения параметра необходимо указывать идентификатор объекта репозитория - База данных, при работе с которой будут использоваться указанные учётные данные. Если в качестве значения параметра передавать значение «$SYSTEM», то указанные учётные данные будут использоваться при работе с менеджером безопасности (работа с пользователями).

ToAdmin. Параметр, определяющий использование учётных данных в качестве учётных данных администратора. По умолчанию свойству установлено значение False, при этом учётные данные используются как учётные данные обычного пользователя. Если передавать значение True, то учётные данные будут использоваться как учётные данные администратора.

Описание

Свойство Credentials определяет учётные данные, установленные в рамках текущей сессии, которые будут использоваться при работе с объектами.

Комментарии

Для работы с реляционными объектами требуются учётные данные, которые используются для авторизации при подключении к серверу. Такие учётные данные могут быть указаны в настройках соответствующей Базы данных репозитория. Если учётные данные в настройках базы данных не указаны, то при первом обращении к объекту будет выдан запрос на ввод учётных данных. При удачном подключении учётные данные будут закешированы и использованы в дальнейшем при работе с другими объектами, которые используют ту же базу данных. учётные данные кешируются в рамках одного соединения с репозиторием.

Используя данное свойство можно указать учётные данные, которые будут применяться при работе с реляционными объектами (либо, при работе с менеджером безопасности), настроенными на указанную в параметре Realm базу данных.

При определенных действиях (например, при создании таблиц) требуются учётные данные администратора. В этом случае необходимо учитывать значение параметра ToAdmin.

Пример

Использования свойства приведено в описании подраздела «Работа с менеджером безопасности».

См. также:

ILogonSession