Admin: 1 revision imported

2021-02-07T06:43:19Z

1 revision imported

Admin: Created page with "{{infobox function |name=IsLocked |object=Объект базы данных |caption=Проверка наличия блокировки |type=1 |status=2 |db=1 |excepti..."

2019-09-23T06:16:37Z

Created page with "{{infobox function |name=IsLocked |object=Объект базы данных |caption=Проверка наличия блокировки |type=1 |status=2 |db=1 |excepti..."

New page

{{infobox function
|name=IsLocked
|object=[[Объект базы данных]]
|caption=Проверка наличия блокировки
|type=1
|status=2
|db=1
|exception=Неподходящий объект
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция проверяет, заблокирован ли уже другим пользователем текущий объект и, если заблокирован, то кем. Функция возвращает:
* '''0''' -- объект не заблокирован в данное время (блокировка возможна).
* '''1''' -- ''текущий'' объект уже заблокирован ранее с помощью функции [[DB.Lock|Lock]], либо является визуальным объектом, открытым для редактирования (блокировка уже активна, нет смысла блокировать второй раз). Данный код результата относится только к текущему объекту, для другого объекта созданного в этом же потоке, позиционированного на тот же самый объект БД, функция будет возвращать ''2'', так как первый объект уже был заблокирован (см. пример).
* '''2''' -- объект был заблокирован другим пользователем или потоком (блокировка в данное время невозможна).

== Синтаксис ==
<code>
{{Grey|DB.}}'''IsLocked'''({{OptionalByRef|<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>}}):''<Тип блокировки (INT)>''
</code>

==== Аргументы ====
* <code>''<Заблокировано пользователем (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется именем пользователя, который заблокировал данный объект, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.
* <code>''<Заблокировано на машине (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется наименованием компьютера, на которым произошла блокировка данного объекта, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.
* <code>''<Время блокировки (DATE)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется датой и временем, когда был заблокирован данный объект, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.

==== Возвращаемое значение ====
Функция возвращает 0, 1 или 2, в зависимости от состояния или возможности блокировки объекта.

== Примеры ==
<pre>
//Блокировка документа аДок
аПольз:="";аМаш:="";аВремя:="";
If аДок.Lock(аПольз,аМаш,аВремя)=0 Then
Message("Невозможно заблокировать документ "+аДок+", так как в данный момент с ним работает пользователь "+аПольз+" на "+аМаш+" в "+аВремя+"!","!");
Exit;
EndIf;
//Функция выводит 1, так как объект заблокирован локально
Message(аДок.IsLocked());
//Создание новой копии объекта
бДок:=аДок.Copy();
//Функция выводит 2, так как другой объект аДок уже имеет блокировку этого документа.
Message(бДок.IsLocked());
//Разблокируем объект
аДок.Unlock();
//Функция выводит 0, так как другой объект аДок больше не имеет блокировки
Message(бДок.IsLocked());
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB.IsLocked - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=IsLocked |object=Объект базы данных |caption=Проверка наличия блокировки |type=1 |status=2 |db=1 |excepti..."