Klasa VariableDispenser

Uzyskuje dostęp do Variables kolekcja podczas wykonywania pakiet.Klasa ta nie może być dziedziczona.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Dts.Runtime.DtsObject
    Microsoft.SqlServer.Dts.Runtime.VariableDispenser

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Runtime
Zestaw:  Microsoft.SqlServer.ManagedDTS (w Microsoft.SqlServer.ManagedDTS.dll)

Składnia

'Deklaracja
Public NotInheritable Class VariableDispenser _
    Inherits DtsObject
'Użycie
Dim instance As VariableDispenser

public sealed class VariableDispenser : DtsObject

public ref class VariableDispenser sealed : public DtsObject

[<SealedAttribute>]
type VariableDispenser =  
    class
        inherit DtsObject
    end

public final class VariableDispenser extends DtsObject

Typ VariableDispenser uwidacznia następujące elementy członkowskie.

Metody

	Nazwa	Opis
	Contains	Określa, czy element można pobrać z VariableDispenser kolekcja za pomocą indeksowania bez niepotrzebnego wyjątek.
	Equals	Określa, czy dwa wystąpienia obiektu są równe. (Dziedziczony z DtsObject).
	Finalize	(Dziedziczony z Object).
	GetHashCode	Zwraca kod skrótu dla tego wystąpienie. (Dziedziczony z DtsObject).
	GetQualifiedName	Zwraca kwalifikowaną nazwę zmiennej.
	GetType	(Dziedziczony z Object).
	GetVariables	Blokuje zmiennych, które są w trybie do odczytu i zapisu i listy tylko do odczytu.
	LockForRead	Zmienna dodaje do listy zmiennych do zablokowania dostępu tylko do odczytu.
	LockForWrite	Zmienna dodaje do listy zmiennych do zablokowania dostępu do odczytu i zapisu.
	LockOneForRead	Umieszcza zmiennej na liście, a następnie blokuje dostęp tylko do odczytu.
	LockOneForWrite	Umieszcza zmiennej na liście, a następnie blokuje dostęp do odczytu i zapisu.
	MemberwiseClone	(Dziedziczony z Object).
	Reset	Czyści listy tylko do odczytu i zapisu i odczytu listy obowiązującymi wywołanie GetVariables kończy się niepowodzeniem.
	ToString	(Dziedziczony z Object).

Do góry

Uwagi

Istnieją dwa scenariusze używania rozdzielacz zmiennej.

1. Ma tylko jedną zmienną.W tym scenariuszu wywołania LockOneForRead lub LockOneForWrite, i zwrócony z jednym elementem kolekcja.

2. Ma wiele zmiennych.W tym scenariuszu wywołania LockForRead i LockForWrite kilka razy, jeden dla każdej zmiennej.Tworzy to dwie listy, jednej listy, która zawiera zmienne do czytania i jednej listy, która zawiera zmienne do zapisu.Następnie należy wywołać GetVariables, która daje kolekcja zawiera wszystkie zmienne zablokowane.Jeśli GetVariables się powiedzie, dwóch list, które są listy nazw zmiennych nie rzeczywiste blokad, są wyczyszczone.

Aby jawnie zwolnić blokady, wywołać Unlock kolekcja.Ta metoda odblokowuje zmienne sami.Jeśli GetVariables się nie powiedzie, wykazy pozostają niezmienione, i może wywołać GetVariables ponownie.Jeśli użytkownik nadal działa w uzyskaniu zmienne, call Reset , aby wyczyścić listy i zmiennej dozownika do jego stanu początkowego.

Variables Kolekcja zawiera Locked właściwość, która wskazuje, czy zmienna rozdzielacz zbiór zmiennych jest zablokowany (true) lub odblokowania (false).Powód, aby przejrzeć tej właściwość jest, że niektóre zadania jawnie zwolnić blokady do zmiennych są używane i wywoływania Unlock dwa razy zgłasza błąd.Dlatego należy używać tej właściwość do określenia, czy dispensed kolekcja jest zablokowany przed wywoływaniem Unlock.

Ważne:
VariableDispenser Jest używana z klas Runtime.Jeśli używasz składników przepływ danych (Microsoft.SqlServer.Dts.Pipeline), a następnie może być konieczna za pomocą IDTSVariableDispenser100 zamiast.Wiedzieć, które zmiennej dozownika do używania, zobacz dokumentację obiektu zmiennych nabywane na i sprawdź zwrotu obiektu, metoda.

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.SqlServer.Dts.Runtime