次の方法で共有


LockOneForRead メソッド

一覧に変数を配置してから、その変数を読み取り専用アクセス用にロックします。

名前空間:  Microsoft.SqlServer.Dts.Runtime
アセンブリ:  Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)

構文

'宣言
Public Sub LockOneForRead ( _
    variable As String, _
    ByRef variables As Variables _
)
'使用
Dim instance As VariableDispenser
Dim variable As String
Dim variables As Variables

instance.LockOneForRead(variable, variables)
public void LockOneForRead(
    string variable,
    ref Variables variables
)
public:
void LockOneForRead(
    String^ variable, 
    Variables^% variables
)
member LockOneForRead : 
        variable:string * 
        variables:Variables byref -> unit 
public function LockOneForRead(
    variable : String, 
    variables : Variables
)

パラメーター

  • variable
    型: System. . :: . .String
    読み取り専用アクセス用にロックする変数の名前です。

説明

このメソッドは、単一の変数のみに対して適用されるため、1 回の呼び出しで LockForRead メソッドおよび GetVariables メソッドの作業が組み合わされます。

呼び出しが成功した場合、要求された変数は、パラメータ variables によって指定された変数コレクション内に 1 つのエントリで構成されたコレクションとして返され、この変数は読み取り専用アクセス用にロックされます。この変数のロックを解除するには、Variables クラスの Unlock メソッドを使用して、変数コレクションを解放します。LockOneForRead メソッドの呼び出しが失敗した場合は、この変数はロックされません。

このメソッドへの呼び出しは、LockForRead への呼び出しを経由して生成されるロックの一覧に影響を与えません。

注意注意

共に使用される複数の変数に対するロックを取得するときに、このメソッドに対する複数の呼び出しを行うと、デッドロックが発生する可能性があるため、このような操作は行わないようにすることをお勧めします。一緒に使用されているすべての変数は、LockForRead メソッドまたは LockForWrite メソッドに続けて GetVariables を呼び出すことにより、一緒に要求およびロックする必要があります。

ロックが成功している場合は、Unlock を呼び出してロックを解除できます。