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
要求された変数を格納する変数のコレクション名。
注釈
このメソッドは、 LockForRead メソッドと GetVariables メソッドの作業を1つの呼び出しで組み合わせており、単一の変数にのみ適用されるためです。
呼び出しが成功すると、要求された変数はパラメータ variablesで指定された変数コレクション内の1エントリコレクションとして返され、その変数は読み取り専用にロックされます。 変数をアンロックするには、VariablesクラスのUnlockメソッドを使って変数コレクションを解放します。
LockOneForReadメソッドへの呼び出しが失敗した場合、変数はロックされません。
このメソッドへの呼び出しは、 LockForRead呼び出しによって生成されるロックリストには影響しません。
Note
変数を一緒に使うロックを取得する際に、このメソッドに複数回呼び出しを行わないことが推奨されます。これはデッドロックにつながる恐れがあります。 一緒に使われるすべての変数は、 LockForRead または LockForWriteメソッドを使ってリクエストし、ロックし、その後 GetVariablesに呼び出しを行ってください。
ロックが成功した場合は、 Unlockに連絡して解除できます。