VariableDispenser.LockOneForRead(String, Variables) 메서드

정의

목록에 변수를 배치하고 읽기 전용 액세스를 위해 잠급니다.

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하여 잠금을 지울 수 있습니다.

적용 대상