VariableDispenser.LockForRead(String) Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Fügt die Variable der Liste der Variablen hinzu, die für den schreibgeschützten Zugriff gesperrt werden sollen.

public:
 void LockForRead(System::String ^ variable);

public void LockForRead (string variable);

member this.LockForRead : string -> unit

Public Sub LockForRead (variable As String)

Parameter

variable

String

Der Name der Variablen, die der Liste der Variablen hinzugefügt werden soll, die für den schreibgeschützten Zugriff gesperrt werden sollen.

Beispiele

Das folgende Codebeispiel erstellt eine VariableDispenser und fügt der Liste, die für das Lesen gesperrt ist, zwei Systemvariablen und eine Systemvariable der Liste hinzu, die für das Schreiben gesperrt ist. Anschließend GetVariables wird aufgerufen, alle drei Variablen in der Auflistung zu sperren, und die Listen werden freigestellt und für neue Variablen zur Verfügung gestellt.

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  

Beispielausgabe:

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

Hinweise

Diese Methode erstellt auf dem ersten Aufruf eine Liste und fügt der Liste die angegebene Variable hinzu. Auf nachfolgenden Aufrufen werden Variablen zur vorhandenen Liste hinzugefügt. Diese Methode sperrt die Variable nicht tatsächlich. Wenn Sie fertig sind, eine Liste der gewünschten Variablen zu erstellen, rufen GetVariables Sie auf, um die Variablen zu sperren, die in dieser Liste gefunden werden. Jede Anzahl von Anrufen an LockForRead und LockForWrite kann vor GetVariables dem Aufruf vorgenommen werden.

Hinweis

Mehrere Clients können gleichzeitig eine schreibgeschützte Sperre für eine Variable erwerben.

Um eine erfolgreiche Sperre zu löschen, wenn Sie fertig sind, rufen Sie auf Unlock.