VariableDispenser.LockForWrite(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 Lese-/Schreibzugriff gesperrt werden sollen.

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

public void LockForWrite(string variable);

member this.LockForWrite : string -> unit

Public Sub LockForWrite (variable As String)

Parameter

variable

String

Der Name der Variable, die zur Liste hinzugefügt werden soll, um für Lese-/Schreibzugriff gesperrt zu werden.

Beispiele

Das folgende Codebeispiel erzeugt eine VariableDispenser und fügt zwei Systemvariablen zur Liste hinzu, die zum Lesen gesperrt ist, sowie eine Variable zur Liste, die zum Schreiben gesperrt ist. Dann wird die aufgerufen GetVariables , um alle drei Variablen in der Sammlung zu sperren, und die Listen werden freigegeben und für neue Variablen bereitgestellt.

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("User:MyVariable");  
            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.LockForWrite("User:MyVariable")  
            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 MyVariable

Description

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 beim ersten Aufruf eine Liste und fügt die gegebene Variable der Liste hinzu. Bei nachfolgenden Anrufen werden Variablen zur bestehenden Liste hinzugefügt. Diese Methode sperrt die Variablen nicht, sondern erstellt lediglich die Liste. Wenn Sie eine Liste der gewünschten Variablen erstellt haben, rufen Sie auf, GetVariables um die in dieser Liste gefundenen Variablen zu sperren. Eine beliebige Anzahl von Anrufen kann LockForReadLockForWrite gemacht werden, bevor GetVariables aufgerufen wird.

Note

Nur ein Client kann gleichzeitig eine Lese-/Schreibsperre für eine gegebene Variable erhalten. Daher ist es, wenn nur Leseberechtigung benötigt wird, am besten, diese zu verwenden LockForRead , um Konflikte im variablen Zugriff zu vermeiden.

Wenn das Schloss erfolgreich war, räumen Sie es durch Aufruf Unlock.