Variables.Locked Eigenschaft

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Ein Boolescher Wert, der angibt, ob die Variablen in der Variables Auflistung gesperrt sind.

public:
 property bool Locked { bool get(); };

public bool Locked { get; }

member this.Locked : bool

Public ReadOnly Property Locked As Boolean

Eigenschaftswert

Boolean

true gibt an, dass die Auflistung gesperrt ist. Ein Wert von false gibt an, dass die Auflistung entsperrt ist.

Beispiele

Im folgenden Codebeispiel wird die Variablensammlung gesperrt, wenn GetVariables sie aufgerufen wird. Das Beispiel bestimmt dann, ob die Auflistung gesperrt ist und, wenn die Auflistung gesperrt ist, aufruft 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  

Hinweise

Die Variables Auflistung enthält eine Locked Eigenschaft, die angibt, ob eine variable Ausgabesammlung von Variablen gesperrt () oder entsperrt ist (truefalse). Der Grund zum Überprüfen dieser Eigenschaft besteht darin, dass einige Aufgaben explizit Sperrungen für die verwendeten Variablen freigeben und Unlock zweimal einen Fehler ausgelöst haben. Daher sollten Sie die Eigenschaft verwenden Locked , ob die verteilte Auflistung vor dem Aufrufen Unlockgesperrt ist.