VariableDispenser.LockOneForRead(String, Variables) Метод

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Runtime

Сборка:

Microsoft.SqlServer.ManagedDTS.dll

Помещает переменную в список и блокирует ее с доступом только для чтения.

public:
 void LockOneForRead(System::String ^ variable, Microsoft::SqlServer::Dts::Runtime::Variables ^ % variables);

public void LockOneForRead (string variable, ref Microsoft.SqlServer.Dts.Runtime.Variables variables);

member this.LockOneForRead : string * Variables -> unit

Public Sub LockOneForRead (variable As String, ByRef variables As Variables)

Параметры

variable

String

Переменная, которая должна быть доступна только для чтения.

variables

Variables

Имя коллекции переменных, в которую должна быть помещена запрошенная переменная.

Комментарии

Этот метод объединяет работу LockForRead метода и GetVariables метода в одном вызове, так как он применяется только к одной переменной.

Если вызов выполнен успешно, запрошенная переменная возвращается в виде коллекции с одной записью в коллекции переменных, указанной параметром variables, и переменная заблокирована для доступа только для чтения. Чтобы разблокировать переменную, отпустите коллекцию переменных с помощью Unlock метода Variables класса. Если вызов LockOneForRead метода завершается ошибкой, переменная не блокируется.

Вызовы этого метода не влияют на список блокировок, созданный с помощью вызовов LockForRead.

Примечание

Рекомендуется не выполнять несколько вызовов этого метода при получении блокировок для совместного использования переменных, так как это может привести к взаимоблокировкам. Все используемые переменные должны быть запрошены и заблокированы с помощью методов LockForRead или LockForWrite, за которым следует вызов GetVariables.

Если блокировка была успешной, ее можно очистить, вызвав .Unlock