VariableDispenser.LockForWrite(String) Metodo

Definizione

Aggiunge la variabile all'elenco di variabili da bloccare per l'accesso in lettura/scrittura.

public:
 void LockForWrite(System::String ^ variable);
public void LockForWrite (string variable);
member this.LockForWrite : string -> unit
Public Sub LockForWrite (variable As String)

Parametri

variable
String

Nome della variabile da aggiungere all'elenco da bloccare per l'accesso in lettura/scrittura.

Esempio

Nell'esempio di codice seguente viene creato un oggetto VariableDispenser e vengono aggiunte due variabili di sistema all'elenco bloccato per la lettura e una variabile all'elenco bloccato per la scrittura. Viene quindi GetVariables chiamato il metodo per bloccare tutte e tre le variabili nella raccolta e gli elenchi vengono liberati e resi disponibili per le nuove variabili.

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  

Esempio di output:

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

Commenti

Questo metodo, alla prima chiamata, crea un elenco e aggiunge la variabile specificata all'elenco. Nelle chiamate successive, le variabili vengono aggiunte all'elenco esistente. Questo metodo non blocca le variabili, bensì crea semplicemente l'elenco. Al termine della creazione di un elenco delle variabili desiderate, chiamare GetVariables per bloccare le variabili presenti nell'elenco. Qualsiasi numero di chiamate a LockForRead e LockForWrite può essere effettuato prima della GetVariables chiamata a.

Nota

Solo un client può acquisire un blocco di lettura/scrittura su una determinata variabile alla volta. Pertanto, se è necessaria solo l'autorizzazione di lettura, è preferibile utilizzare LockForRead per evitare conflitti nell'accesso alle variabili.

Se il blocco ha avuto esito positivo, cancellarlo chiamando Unlock .

Si applica a