VariableDispenser.LockForRead(String) 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Runtime

어셈블리:

Microsoft.SqlServer.ManagedDTS.dll

읽기 전용 액세스를 위해 잠글 변수 목록에 변수를 추가합니다.

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합니다.