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 .