语言

VariableDispenser.Reset 方法

定义

调用失败时 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 方法重新填充锁列表。

适用于