VariableDispenser.LockOneForWrite メソッド
一覧に変数を配置してから、読み取り/書き込み用アクセス用にその変数をロックします。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Sub LockOneForWrite ( _
variable As String, _
ByRef variables As Variables _
)
'使用
Dim instance As VariableDispenser
Dim variable As String
Dim variables As Variables
instance.LockOneForWrite(variable, variables)
public void LockOneForWrite(
string variable,
ref Variables variables
)
public:
void LockOneForWrite(
String^ variable,
Variables^% variables
)
member LockOneForWrite :
variable:string *
variables:Variables byref -> unit
public function LockOneForWrite(
variable : String,
variables : Variables
)
パラメーター
- variable
型: System.String
読み取り/書き込みアクセス用にロックする変数の名前です。
- variables
型: Microsoft.SqlServer.Dts.Runtime.Variables%
要求された変数を格納する変数コレクションの名前です。
説明
このメソッドは、単一の変数のみに対して適用されるため、1 回の呼び出しで LockForWrite メソッドおよび GetVariables メソッドの作業が組み合わされます。
呼び出しが成功した場合、要求された変数は、パラメーター variables によって指定された変数コレクション内に 1 つのエントリで構成されたコレクションとして返され、この変数は読み取り/書き込みアクセスに用にロックされます。 この変数のロックを解除するには、Variables クラスの Unlock メソッドを使用して、変数コレクションを解放します。 LockOneForWrite メソッドの呼び出しが失敗した場合は、この変数はロックされません。
このメソッドへの呼び出しは、LockForWrite への呼び出しによって生成されるロックの一覧に影響を与えません。
.gif "注意") 注 |
|---|
共に使用される複数の変数に対するロックを取得するときに、このメソッドに対する複数の呼び出しを行うと、デッドロックが発生する可能性があるため、このような操作は行わないようにすることをお勧めします。 一緒に使用されているすべての変数は、LockForRead メソッドまたは LockForWrite メソッドに続けて GetVariables メソッドを呼び出すことにより、一緒に要求およびロックする必要があります。 |
ロックが成功している場合は、Unlock を呼び出してロックを解除できます。