Udostępnij za pośrednictwem

  • Artykuł

Metoda VariableDispenser.LockForRead

Zmienna dodaje do listy zmiennych do zablokowania dostępu tylko do odczytu.

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

Składnia

'Deklaracja
Public Sub LockForRead ( _
    variable As String _
)
'Użycie
Dim instance As VariableDispenser
Dim variable As String

instance.LockForRead(variable)

public void LockForRead(
    string variable
)

public:
void LockForRead(
    String^ variable
)

member LockForRead : 
        variable:string -> unit 

public function LockForRead(
    variable : String
)

Parametry

  • variable
    Typ: System.String
    Nazwa zmiennej, aby dodać do listy do zablokowania dostępu tylko do odczytu.

Uwagi

Ta metoda na jego pierwsze wywołanie tworzy listę i dodaje do listy danej zmiennej.Na kolejnych zaproszeń zmienne są dodawane do istniejącej listy.Ta metoda jest rzeczywiście blokada zmiennej.Po zakończeniu tworzenia listy zmienne środowiskowe, call GetVariables do blokada zmiennych, które znajdują się na liście.Dowolna liczba wywołań LockForRead i LockForWrite może być dokonana przed GetVariables jest wywoływana.

Ostrzeżenie

Wielu klientów jednocześnie może nabywać tylko do odczytu blokada na zmienną.

Po zakończeniu, należy wyczyścić pomyślne blokada, wywołanie Unlock.

Przykłady

Poniższy kod ilustruje tworzenie VariableDispenser i dodaje dwa zmienna systemowas do listy, która jest zablokowane do odczytu, a jeden zmienna systemowa do listy, która jest zablokowana do pisania.Następnie GetVariables wywoływana jest blokada wszystkie trzy zmienne w zbieraniu i wykazy są zwalniane i udostępniane dla nowych zmiennych.

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);           
            // Verify that the variable is locked before unlocking.
            Console.WriteLine("Variables are locked? {0}", vars.Locked);
            foreach (Variable myVar in vars)
            {
                Console.WriteLine("Name        {0}", myVar.Name);
                Console.WriteLine("Description {0}", myVar.Description);
                Console.WriteLine();
            }
            // Use Contains to determine whether indexing can be used.
            Boolean pkgName = variableDispenser.Contains("PackageName");
            String qName = variableDispenser.GetQualifiedName("PackageName");
            Console.WriteLine("Contains is valid?       {0}", pkgName);
            Console.WriteLine("Fully qualified name is: {0}", qName);

            vars.Unlock();

            Console.WriteLine("Variables are locked? {0}", vars.Locked);
        }
    }
}

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)
            ' Verify that the variable is locked before unlocking.
            Console.WriteLine("Variables are locked? {0}", vars.Locked)
            Dim myVar As Variable
            For Each myVar In vars
                Console.WriteLine("Name        {0}", myVar.Name)
                Console.WriteLine("Description {0}", myVar.Description)
                Console.WriteLine()
            Next
            ' Use Contains to determine whether indexing can be used.
            Dim pkgName As Boolean =  variableDispenser.Contains("PackageName") 
            Dim qName As String =  variableDispenser.GetQualifiedName("PackageName") 
            Console.WriteLine("Contains is valid?       {0}", pkgName)
            Console.WriteLine("Fully qualified name is: {0}", qName)

            vars.Unlock()

            Console.WriteLine("Variables are locked? {0}", vars.Locked)
        End Sub
    End Class
End Namespace

Przykładowe dane wyjściowe:

Variables are locked? True

Name OfflineMode

Description The offline mode currently set for the package

Name PackageName

Description The package name

Contains is valid? True

Fully qualified name is: System::PackageName

Variables are locked? False