VariableDispenser.LockForRead(String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
읽기 전용 액세스를 위해 잠글 변수 목록에 변수를 추가합니다.
public:
void LockForRead(System::String ^ variable);
public void LockForRead (string variable);
member this.LockForRead : string -> unit
Public Sub LockForRead (variable As String)
매개 변수
- variable
- String
읽기 전용 액세스를 위해 잠글 변수 목록에 추가할 변수의 이름입니다.
예제
다음 코드 예제에서는 읽기 위해 잠긴 목록에 두 개의 시스템 변수를 만들고 VariableDispenser 추가하고, 한 개의 시스템 변수를 쓰기 위해 잠긴 목록에 추가합니다. 그런 다음 컬렉션에 GetVariables 있는 세 개의 변수를 모두 잠그도록 호출되고 목록이 해제되어 새 변수에 사용할 수 있게 됩니다.
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
namespace Microsoft.SqlServer.SSIS.Sample
{
class Program
{
static void Main(string[] args)
{
Package pkg = new Package();
Variables vars = null;
VariableDispenser variableDispenser = pkg.VariableDispenser;
variableDispenser.LockForRead("System::PackageName");
variableDispenser.LockForRead("System::OfflineMode");
variableDispenser.GetVariables(ref vars);
// Verify that the variable is locked before unlocking.
Console.WriteLine("Variables are locked? {0}", vars.Locked);
foreach (Variable myVar in vars)
{
Console.WriteLine("Name {0}", myVar.Name);
Console.WriteLine("Description {0}", myVar.Description);
Console.WriteLine();
}
// Use Contains to determine whether indexing can be used.
Boolean pkgName = variableDispenser.Contains("PackageName");
String qName = variableDispenser.GetQualifiedName("PackageName");
Console.WriteLine("Contains is valid? {0}", pkgName);
Console.WriteLine("Fully qualified name is: {0}", qName);
vars.Unlock();
Console.WriteLine("Variables are locked? {0}", vars.Locked);
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Namespace Microsoft.SqlServer.SSIS.Sample
Class Program
Shared Sub Main(ByVal args() As String)
Dim pkg As Package = New Package()
Dim vars As Variables = Nothing
Dim variableDispenser As VariableDispenser = pkg.VariableDispenser
variableDispenser.LockForRead("System::PackageName")
variableDispenser.LockForRead("System::OfflineMode")
variableDispenser.GetVariables( vars)
' Verify that the variable is locked before unlocking.
Console.WriteLine("Variables are locked? {0}", vars.Locked)
Dim myVar As Variable
For Each myVar In vars
Console.WriteLine("Name {0}", myVar.Name)
Console.WriteLine("Description {0}", myVar.Description)
Console.WriteLine()
Next
' Use Contains to determine whether indexing can be used.
Dim pkgName As Boolean = variableDispenser.Contains("PackageName")
Dim qName As String = variableDispenser.GetQualifiedName("PackageName")
Console.WriteLine("Contains is valid? {0}", pkgName)
Console.WriteLine("Fully qualified name is: {0}", qName)
vars.Unlock()
Console.WriteLine("Variables are locked? {0}", vars.Locked)
End Sub
End Class
End Namespace
샘플 출력:
Variables are locked? True
Name OfflineMode
Description The offline mode currently set for the package
Name PackageName
Description The package name
Contains is valid? True
Fully qualified name is: System::PackageName
Variables are locked? False
설명
이 메서드는 첫 번째 호출에서 목록을 만들고 지정된 변수를 목록에 추가합니다. 후속 호출 시 변수가 기존 목록에 추가됩니다. 이 메서드는 실제로 변수를 잠그지 않습니다. 원하는 변수 목록을 만들면 호출 GetVariables 하여 이 목록에 있는 변수를 잠급니다. 호출하기 LockForRead 전에 GetVariables 호출할 수 있고 LockForWrite 호출할 수 있는 모든 수입니다.
참고
여러 클라이언트가 동시에 변수에 대한 읽기 전용 잠금을 획득할 수 있습니다.
완료되면 성공적인 잠금을 지우려면 .을(를) 호출 Unlock합니다.