语言

Variables.Unlock 方法

定义

释放变量集合的锁,并将变量集合的状态标记为无效或未知。

public:
 void Unlock();
public void Unlock();
member this.Unlock : unit -> unit
Public Sub Unlock ()

示例

以下代码示例在调用时锁定变量集合 GetVariables 。 示例随后检查集合是否被锁定,如果是,调用 Unlock。

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("System::InteractiveMode");  
            variableDispenser.GetVariables(ref vars);             
            // Determine whether the variable collection is locked before unlocking.  
            Boolean isLocked = vars.Locked;  

            // Verify the value of vars.Locked. If the lock failed,  
            // call Reset.  
            if (isLocked)  
            {  
                vars.Unlock();  
            }  
            else  
            {  
                variableDispenser.Reset();  
            }  
        }  
    }  
}  
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("System::InteractiveMode")  
            variableDispenser.GetVariables( vars)  
            ' Determine whether the variable collection is locked before unlocking.  
            Dim isLocked As Boolean =  vars.Locked   

            ' Verify the value of vars.Locked. If the lock failed,  
            ' call Reset.  
            If isLocked = True Then  
                vars.Unlock()  
            Else   
                variableDispenser.Reset()  
            End If  
        End Sub  
    End Class  
End Namespace  

注解

该方法用于解锁因使用该 VariableDispenser 类而被锁定的变量。 当 VariableDispenser 发送变量集合时,它会在列表中跟踪该集合。 当调用变量分配器的任务执行完成后,所有分配的集合都会自动解锁。 因此,如果自动解锁适合您的需求,且自动解锁是在任务完成时发生的,您无需联系 Unlock 该方法。 然而,出于性能考虑,有时尽快解锁变量是更理想的。 显式调用该 Unlock 方法即可解锁变量。

该 Locked 属性返回一个值, false 表示已分配的集合已被解锁。 值 表示 true 变量集合仍然被锁定。 叫 Unlock 两次会导致错误;因此,在某些情况下,你可能需要先检查该属性的价值,再决定是否叫 Unlock。

适用于