VariableDispenser.LockOneForWrite(String, Variables) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
変数をリストに入れ、読み書きアクセスのためにロックします。
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 -> unitPublic Sub LockOneForWrite (variable As String, ByRef variables As Variables)パラメーター
- variable
- String
読み書きアクセスのためにロックする変数の名前。
- variables
- Variables
要求された変数を格納する変数のコレクション名。
注釈
このメソッドは、 LockForWrite メソッドと GetVariables メソッドの作業を1つの呼び出しで組み合わせ、単一の変数にのみ適用されます。
呼び出しが成功すると、要求された変数はパラメータ variablesで指定された変数コレクション内の1エントリコレクションとして返され、その変数は読み書きアクセスにロックされます。 変数をアンロックするには、変数クラスの Unlock メソッドを使って変数コレクションを解放します。
LockOneForWriteメソッド呼び出しが失敗した場合、その変数はロックされません。
このメソッドへの呼び出しは、 LockForWriteへの呼び出しによって生成されるロックリストには影響しません。
Note
変数を一緒に使うロックを取得する際に、このメソッドに複数回呼び出しを行わないことが推奨されます。これはデッドロックにつながる恐れがあります。 一緒に使われるすべての変数は、メソッド LockForRead または LockForWriteを呼び出し、その後 GetVariables メソッドに呼び出すことで要求し、ロックする必要があります。
ロックが成功した場合は、 Unlockに連絡して解除できます。