VariableDispenser.LockForWrite(String) 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Runtime

어셈블리:

Microsoft.SqlServer.ManagedDTS.dll

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

public:
 void LockForWrite(System::String ^ variable);

public void LockForWrite (string variable);

member this.LockForWrite : string -> unit

Public Sub LockForWrite (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.LockForWrite("User:MyVariable");  
            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.LockForWrite("User:MyVariable")  
            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 MyVariable

Description

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 모든 호출 수입니다.

참고

한 번에 하나의 클라이언트만 지정된 변수에 대한 읽기/쓰기 잠금을 획득할 수 있습니다. 따라서 읽기 권한만 필요한 경우 변수 액세스에서 충돌을 방지하는 데 사용하는 LockForRead 것이 가장 좋습니다.

잠금이 성공한 경우 .Unlock