VariableDispenser.LockOneForRead(String, Variables) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将变量放入列表中，然后锁定它以进行只读访问。
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
要将所请求的变量放入其中的变量集合的名称。
注解
此方法在一次调用中合并了该方法和GetVariables方法的工作LockForRead，因为它仅适用于单个变量。
如果调用成功，则请求的变量将作为参数 variables指定的变量集合中的一个条目集合返回，并且该变量被锁定以进行只读访问。 若要解锁变量，请使用 Unlock 类的方法 Variables 释放变量集合。 如果对 LockOneForRead 方法的调用失败，则变量不会锁定。
对此方法的调用不会影响通过调用 LockForRead生成的锁列表。
注意
建议在获取变量的锁时不要对此方法进行多次调用，因为这可能会导致死锁。 应使用方法 LockForRead 请求并锁定在一起的所有变量，然后 LockForWrite是调用 GetVariables。
如果锁定成功，可以通过调用 Unlock来清除它。