VariableDispenser.Reset 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
调用失败时 GetVariables(Variables) ,清除只读列表和读写列表。
public:
void Reset();
public void Reset();
member this.Reset : unit -> unit
Public Sub Reset ()
示例
以下代码示例锁定一组变量,然后确定该变量集合是否被锁定,再解锁它们。 如果锁失效,则 Reset 调用。
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);
// Determine whether the variable collection is locked.
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.GetVariables( vars)
' Determine whether the variable collection is locked.
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
注解
该方法可用于在调用 GetVariables 失败后清除只读列表和读写锁列表。 如果 GetVariables 调用失败,锁列表不会被清除,因此如果你再次调用 GetVariables ,会尝试锁定相同的变量。 如果你想重新尝试锁定相同的变量,可以 GetVariables 先调用一次,不要先调用 Reset 。 或者,你可以选择使用此方法释放列表,放弃操作,直到所有必要变量都可用并一次性锁定。
此外,当你收到失败GetVariables通知,想锁定一组完全不同且无关的变量时,也会使用该Reset方法。 你会调用 Reset 清除锁列表,然后通过 LockForRead、 LockForWrite、 LockOneForRead和 LockOneForWrite 方法重新填充锁列表。