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

Определение

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

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 .

Применяется к