VariableDispenser.LockForWrite(String) Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Agrega la variable a la lista de variables que se van a bloquear para el acceso de lectura y escritura.

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

public void LockForWrite (string variable);

member this.LockForWrite : string -> unit

Public Sub LockForWrite (variable As String)

Parámetros

variable

String

El nombre de la variable que se va a agregar a la lista que se va a bloquear para el acceso de lectura y escritura.

Ejemplos

En el ejemplo de código siguiente se crea y VariableDispenser se agregan dos variables del sistema a la lista bloqueadas para la lectura y una variable a la lista bloqueada para escribir. GetVariables A continuación, se llama a para bloquear las tres variables de la colección, y las listas se liberan y están disponibles para las nuevas variables.

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  

Salida del ejemplo:

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

Comentarios

Este método, en su primera llamada, crea una lista y agrega la variable especificada a la lista. En las llamadas posteriores, las variables se agregan a la lista existente. Este método no bloquea las variables, simplemente crea la lista. Cuando haya terminado de crear una lista de las variables que desee, llame GetVariables a para bloquear las variables que se encuentran en esta lista. Cualquier número de llamadas a LockForRead y LockForWrite se puede realizar antes GetVariables de llamar a .

Nota

Solo un cliente puede adquirir un bloqueo de lectura y escritura en cualquier variable determinada a la vez. Por lo tanto, si solo se necesita el permiso de lectura, es mejor usar LockForRead para ayudar a evitar conflictos en el acceso a variables.

Si el bloqueo se realizó correctamente, desactivela llamando a Unlock.