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 -> unitPublic Sub LockOneForRead (variable As String, ByRef variables As Variables)Параметры
- variable
- String
Переменная, которая должна быть доступна только для чтения.
- variables
- Variables
Имя коллекции переменных, в которую должна быть помещена запрошенная переменная.
Комментарии
Этот метод объединяет работу LockForRead метода и GetVariables метода в одном вызове, так как он применяется только к одной переменной.
Если вызов выполнен успешно, запрошенная переменная возвращается в виде коллекции с одной записью в коллекции переменных, указанной параметром variables, и переменная заблокирована для доступа только для чтения. Чтобы разблокировать переменную, отпустите коллекцию переменных с помощью Unlock метода Variables класса. Если вызов LockOneForRead метода завершается ошибкой, переменная не блокируется.
Вызовы этого метода не влияют на список блокировок, созданный с помощью вызовов LockForRead.
Примечание
Рекомендуется не выполнять несколько вызовов этого метода при получении блокировок для совместного использования переменных, так как это может привести к взаимоблокировкам. Все используемые переменные должны быть запрошены и заблокированы с помощью методов LockForRead или LockForWrite, за которым следует вызов GetVariables.
Если блокировка была успешной, ее можно очистить, вызвав .Unlock