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 메서드를 한 번의 호출로 결합합니다.
호출이 성공하면 요청된 변수가 매개 변수 variables로 지정된 변수 컬렉션에서 한 항목 컬렉션으로 반환되고 읽기 전용 액세스를 위해 변수가 잠깁니다. 변수의 잠금을 해제하려면 클래스의 메서드를 Unlock 사용하여 변수 컬렉션을 해제합니다 Variables . 메서드 호출이 LockOneForRead 실패하면 변수가 잠기지 않습니다.
이 메서드에 대한 호출은 호출 LockForRead을 통해 생성된 잠금 목록에 영향을 미치지 않습니다.
참고
교착 상태가 발생할 수 있으므로 함께 사용할 변수에 대한 잠금을 획득할 때 이 메서드를 여러 차례 호출하지 않는 것이 좋습니다. 함께 사용되는 모든 변수는 메서드 LockForRead 또는 LockForWrite호출 GetVariables을 사용하여 함께 요청 및 잠가야 합니다.
잠금이 성공하면 .을(를) 호출 Unlock하여 잠금을 지울 수 있습니다.