Udostępnij za pośrednictwem

  • Artykuł

Metoda Variables.Unlock

Zwalnia blokad w zbiorze zmiennych i flagi stanu kolekcja zmienne jako nieprawidłowy lub nieznany.

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Runtime
Zestaw:  Microsoft.SqlServer.ManagedDTS (w Microsoft.SqlServer.ManagedDTS.dll)

Składnia

'Deklaracja
Public Sub Unlock
'Użycie
Dim instance As Variables

instance.Unlock()

public void Unlock()

public:
void Unlock()

member Unlock : unit -> unit 

public function Unlock()

Uwagi

Ta metoda jest używana do odblokowania zmiennych, które zostały zablokowane przy użyciu VariableDispenser klasyGdy VariableDispenser zrezygnuje zbiór zmiennych on informacje o kolekcja liście.Po zakończeniu wykonywania zadania o nazwie zmiennej rozdzielacz wszystkie kolekcje dispensed są odblokowywane automatycznie.Dlatego jeśli automatyczne odblokowywanie jest odpowiednia dla Twoich potrzeb i automatyczne odblokowywanie wystąpił po wykonaniu zadania, nie musisz wywołać Unlock metoda.Jednak czasami jest pożądane, aby odblokować zmienne jak najszybciej, ze względu na wydajność.Jawne wywołanie tej Unlock metoda odblokowuje zmiennych.

Locked Właściwość zwraca wartość false oznacza dispensed kolekcja już została odblokowana.Wartość true wskazuje zmienna kolekcja jest wciąż zablokowany.Wywołanie Unlock dwa razy powoduje błąd; w niektórych sytuacjach użytkownik może więc sprawdzić wartość tej właściwość przed podjęciem decyzji, czy wywołanie Unlock.

Przykłady

Poniższy przykład kodu blokuje zmiennej kolekcja po GetVariables jest wywoływana.Przykład sprawdza następnie, jeśli kolekcja jest zablokowany i jeśli tak, wywołuje 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