VariableDispenser.LockOneForWrite(String, Variables) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Помещает переменную в список и блокирует ее с доступом для чтения и записи.
public:
void LockOneForWrite(System::String ^ variable, Microsoft::SqlServer::Dts::Runtime::Variables ^ % variables);
public void LockOneForWrite (string variable, ref Microsoft.SqlServer.Dts.Runtime.Variables variables);
member this.LockOneForWrite : string * Variables -> unit
Public Sub LockOneForWrite (variable As String, ByRef variables As Variables)
Параметры
- variable
- String
Имя переменной, которая должна быть доступна для чтения и записи.
- variables
- Variables
Имя коллекции переменных, в которую должна быть помещена запрошенная переменная.
Комментарии
Этот метод объединяет работу LockForWrite метода и GetVariables метод в одном вызове, так как он применяется только к одной переменной.
Если вызов выполнен успешно, запрошенная переменная возвращается в виде однозаписной коллекции в коллекции переменных, указанной параметром variables
, и переменная заблокирована для доступа на чтение и запись. Чтобы разблокировать переменную, отпустите коллекцию переменных с помощью Unlock метода класса Variables. Если вызов метода завершается сбоем LockOneForWrite , переменная не заблокирована.
Вызовы этого метода не влияют на список блокировок, создаваемый вызовами LockForWrite.
Примечание
Рекомендуется не выполнять несколько вызовов этого метода при получении блокировок для совместного использования переменных, так как это может привести к взаимоблокировкам. Все используемые вместе переменные следует запрашивать и блокировать, вызывая методы LockForRead или LockForWriteвызывая GetVariables метод.
Если блокировка прошла успешно, ее можно очистить, вызвав .Unlock