Freigeben über


Variables Klasse

Definition

Enthält eine Auflistung von Variables-Objekten, auf die über mehrere Objekte zugegriffen wird. Diese Klasse kann nicht vererbt werden.

public ref class Variables sealed : Microsoft::SqlServer::Dts::Runtime::DTSReadOnlyCollectionBase
public sealed class Variables : Microsoft.SqlServer.Dts.Runtime.DTSReadOnlyCollectionBase
type Variables = class
    inherit DTSReadOnlyCollectionBase
Public NotInheritable Class Variables
Inherits DTSReadOnlyCollectionBase
Vererbung

Hinweise

Integration Services (SSIS) stellt Systemvariablen bereit und unterstützt benutzerdefinierte Benutzervariablen. Wenn Sie ein neues Paket erstellen, einen Container oder eine Aufgabe zum Paket hinzufügen oder einen Ereignishandler erstellen, enthält SSIS automatisch eine Reihe von Systemvariablen für das Element. Systemvariablen befinden sich immer im System Namespace. System Variablen enthalten nützliche Informationen über das Paket und seine Container, Aufgaben und Ereignishandler. System Variablen enthalten Informationen wie den Namen des Computers, auf dem das Paket ausgeführt wird, und den Zeitpunkt, zu dem das Paket gestartet wird. Sie können die Informationen anzeigen, die in einer Systemvariable enthalten sind, Sie können jedoch keine Systemvariablen hinzufügen oder aktualisieren.

Sie können auch benutzerdefinierte Variablen für die Verwendung in Paketen, Containern, Aufgaben, Transformationen und Rangfolgeeinschränkungen erstellen. Benutzerdefinierte Variablen können im Namespace oder einem User Namespace Ihrer Wahl erstellt werden. Benutzerdefinierte Variablen können in den Ausdrücken verwendet werden, die der For Loop-Container, die abgeleitete Spaltentransformation, die bedingte Split-Transformation und Rangfolgeeinschränkungen enthalten können. Weitere Informationen finden Sie unter Verwenden von Variablen in Paketen.

Jeder Container im SSIS-Objektmodell verfügt über eine Variables Auflistung. Auf diese Auflistung kann auf jedes untergeordnete Element des Containers zugegriffen werden. Auf eine Variable wird über den Namen oder den Index aus der Auflistung zugegriffen. Die Variables Auflistung auf einem Container stellt eine Aggregation der Variablen in der Auflistung des übergeordneten Elements dar. Die Variables Auflistung der Package Klasse ist für alle Objekte im Paket sichtbar und stellt eine global sichtbare Auflistung bereit. Umgekehrt sind die variablen, die in einer Aufgabe enthalten sind, in Bereich und Sichtbarkeit begrenzt und sind nur von der Aufgabe sichtbar.

Wichtig

Dies Variables wird mit den Runtime-Klassen verwendet. Wenn Sie Datenflusskomponenten (Microsoft.SqlServer.Dts.Pipeline) verwenden, müssen Sie möglicherweise die IDTSVariables100. Informationen dazu, welche Variablensammlung verwendet werden soll, finden Sie in der Dokumentation für das Objekt, auf dem Sie Variablen erwerben, und überprüfen Sie den Rückgabewert.

Felder

m_unmanagedColl

Die nicht verwaltete Auflistung.

(Geerbt von DTSReadOnlyCollectionBase)

Eigenschaften

Count

Ruft die Anzahl der in der DTSReadOnlyCollectionBase-Instanz enthaltenen Elemente ab.

(Geerbt von DTSReadOnlyCollectionBase)
IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf DTSReadOnlyCollectionBase synchronisiert (threadsicher) ist.

(Geerbt von DTSReadOnlyCollectionBase)
Item[Object]

Gibt ein Variable-Objekt aus der Variables-Auflistung zurück.

Locked

Ein boolescher Wert, der angibt, ob die Variablen in der Variables Auflistung gesperrt sind.

SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf DTSReadOnlyCollectionBase synchronisiert werden kann.

(Geerbt von DTSReadOnlyCollectionBase)

Methoden

Add(String, Boolean, String, Object)

Fügt der Variable-Auflistung ein Variables-Objekt hinzu.

Contains(Object)

Gibt einen booleschen Wert zurück, der angibt, ob auf die Elemente in der Auflistung mithilfe der Indizierung zugegriffen werden kann, ohne eine Ausnahme zu auslösen.

CopyTo(Array, Int32)

Kopiert die gesamte DTSReadOnlyCollectionBase in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.

(Geerbt von DTSReadOnlyCollectionBase)
CreateManagedObject(Object)

Erstellt ein verwaltetes Objekt aus einem nicht verwalteten Objekt.

(Geerbt von DTSReadOnlyCollectionBase)
GetCount()

Ruft die Anzahl der Objekte in der Auflistung ab.

(Geerbt von DTSReadOnlyCollectionBase)
GetEnumerator()

Gibt einen VariableEnumerator-Enumerator zum Durchlaufen der Variables-Auflistung zurück.

GetManagedEnumerator(Object)

Ruft den verwalteten Enumerator aus einem nicht verwalteten Enumerator ab.

(Geerbt von DTSReadOnlyCollectionBase)
Join(Variable)

Verknüpft die Variable mit der Variables-Auflistung.

Remove(Object)

Entfernt ein Variable-Objekt aus der Variables-Auflistung.

Unlock()

Hebt die Sperren der Variablenauflistung auf und kennzeichnet den Status der Variablenauflistung als ungültig oder unbekannt.

Gilt für: