VariableDispenser.LockForWrite(String) Metode

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Menambahkan variabel ke daftar variabel yang akan dikunci untuk akses baca/tulis.

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

Nama variabel yang akan ditambahkan ke daftar yang akan dikunci untuk akses baca/tulis.

Contoh

Contoh kode berikut membuat VariableDispenser dan menambahkan dua variabel sistem ke daftar yang dikunci untuk dibaca, dan satu variabel ke daftar yang dikunci untuk ditulis. Kemudian dipanggil GetVariables untuk mengunci ketiga variabel dalam koleksi, dan daftar dibebaskan dan tersedia untuk variabel baru.

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  

Contoh 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

Keterangan

Metode ini, pada panggilan pertamanya, membuat daftar dan menambahkan variabel yang diberikan ke daftar. Pada panggilan berikutnya, variabel ditambahkan ke daftar yang ada. Metode ini tidak mengunci variabel, itu hanya membuat daftar. Setelah selesai membuat daftar variabel yang Anda inginkan, panggil GetVariables untuk mengunci variabel yang ditemukan dalam daftar ini. Sejumlah panggilan ke LockForRead dan LockForWrite dapat dilakukan sebelumnya GetVariables dipanggil.

Catatan

Hanya satu klien yang dapat memperoleh kunci baca/tulis pada variabel tertentu pada satu waktu. Oleh karena itu, jika hanya izin baca yang diperlukan, yang terbaik adalah menggunakan LockForRead untuk membantu menghindari konflik dalam akses variabel.

Jika kunci berhasil, bersihkan dengan memanggil Unlock.