Metoda VariableDispenser.LockForWrite
Zmienna dodaje do listy zmiennych do zablokowania dostępu do odczytu i zapisu.
Przestrzeń nazw: Microsoft.SqlServer.Dts.Runtime
Zestaw: Microsoft.SqlServer.ManagedDTS (w Microsoft.SqlServer.ManagedDTS.dll)
Składnia
'Deklaracja
Public Sub LockForWrite ( _
variable As String _
)
'Użycie
Dim instance As VariableDispenser
Dim variable As String
instance.LockForWrite(variable)
public void LockForWrite(
string variable
)
public:
void LockForWrite(
String^ variable
)
member LockForWrite :
variable:string -> unit
public function LockForWrite(
variable : String
)
Parametry
- variable
Typ: System.String
Nazwa zmiennej, aby dodać do listy zablokowanych dla dostępu do odczytu i zapisu.
Uwagi
Ta metoda na jego pierwsze wywołanie tworzy listę i dodaje do listy danej zmiennej.Na kolejnych zaproszeń zmienne są dodawane do istniejącej listy.Ta metoda nie blokada zmienne, go jedynie tworzy listę.Po zakończeniu tworzenia listy zmienne środowiskowe, call GetVariables do blokada zmiennych, które znajdują się na liście.Dowolna liczba wywołań LockForRead i LockForWrite może być dokonana przed GetVariables jest wywoływana.
Ostrzeżenie
Tylko jeden klient może nabywać blokada odczytu i zapisu na dowolnej zmiennej określonej w jednym czas.Dlatego jeśli jest potrzebna tylko uprawnienia do odczytu, najlepiej używać LockForRead Aby uniknąć konfliktów w zmiennej dostępu.
Jeśli blokada była udana, wyczyść je, wywołując Unlock.
Przykłady
Poniższy kod ilustruje tworzenie VariableDispenser i dodaje dwie zmienne systemowe do listy, która jest zablokowane do odczytu, a jedną zmienną do listy, który jest zablokowany do pisania.Następnie GetVariables wywoływana jest blokada wszystkie trzy zmienne w zbieraniu i wykazy są zwalniane i udostępniane dla nowych zmiennych.
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
Przykładowe dane wyjściowe:
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