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 -> 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 。