Variables.Unlock 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
释放变量集合的锁,并将变量集合的状态标记为无效或未知。
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。