Freigeben über


Variables-Klasse

Contains a collection of Variables objects, which are accessed through several objects. This class cannot be inherited.

Vererbungshierarchie

System. . :: . .Object
  Microsoft.SqlServer.Dts.Runtime. . :: . .DTSReadOnlyCollectionBase
    Microsoft.SqlServer.Dts.Runtime..::..Variables

Namespace:  Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

Syntax

'Declaration
Public NotInheritable Class Variables _
    Inherits DTSReadOnlyCollectionBase
'Usage
Dim instance As Variables
public sealed class Variables : DTSReadOnlyCollectionBase
public ref class Variables sealed : public DTSReadOnlyCollectionBase
[<SealedAttribute>]
type Variables =  
    class
        inherit DTSReadOnlyCollectionBase
    end
public final class Variables extends DTSReadOnlyCollectionBase

Der Variables-Typ macht folgende Elemente verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Count Gets the number of elements contained in the DTSReadOnlyCollectionBase instance. (Geerbt von DTSReadOnlyCollectionBase.)
Öffentliche Eigenschaft IsSynchronized Gets a value that indicates whether access to the DTSReadOnlyCollectionBase is synchronized (thread-safe). (Geerbt von DTSReadOnlyCollectionBase.)
Öffentliche Eigenschaft Item Returns a Variable object from the Variables collection.
Öffentliche Eigenschaft Locked A Boolean indicating whether the variables in the Variables collection are locked.
Öffentliche Eigenschaft SyncRoot Gets an object that can be used to synchronize access to the DTSReadOnlyCollectionBase. (Geerbt von DTSReadOnlyCollectionBase.)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Add Adds a Variable object to the Variables collection.
Öffentliche Methode Contains Returns a Boolean that indicates whether the items in the collection can be accessed by using indexing without throwing an exception.
Öffentliche Methode CopyTo Copies the entire DTSReadOnlyCollectionBase to a compatible one-dimensional array, starting at the specified index of the target array. (Geerbt von DTSReadOnlyCollectionBase.)
Geschützte Methode CreateManagedObject Infrastruktur (Geerbt von DTSReadOnlyCollectionBase.)
Öffentliche Methode Equals (Geerbt von Object.)
Geschützte Methode Finalize (Geerbt von Object.)
Geschützte Methode GetCount Infrastruktur (Geerbt von DTSReadOnlyCollectionBase.)
Öffentliche Methode GetEnumerator Returns a VariableEnumerator enumerator for use in iterating over the Variables collection.
Öffentliche Methode GetHashCode (Geerbt von Object.)
Geschützte Methode GetManagedEnumerator Infrastruktur (Geerbt von DTSReadOnlyCollectionBase.)
Öffentliche Methode GetType (Geerbt von Object.)
Geschützte Methode MemberwiseClone (Geerbt von Object.)
Öffentliche Methode Remove Removes a Variable object from the Variables collection.
Öffentliche Methode ToString (Geerbt von Object.)
Öffentliche Methode Unlock Releases the locks on the variables collection and flags the state of the variables collection as invalid or unknown.

Zum Anfang

Felder

  Name Beschreibung
Geschütztes Feld m_unmanagedColl Infrastruktur (Geerbt von DTSReadOnlyCollectionBase.)

Zum Anfang

Hinweise

Integration Services (SSIS) provides system variables and supports custom user variables. When you create a new package, add a container or a task to the package, or create an event handler, SSIS automatically includes a set of system variables for the item. System variables are always located in the System namespace. System variables contain useful information about the package and its containers, tasks, and event handlers. System variables contain information such as the name of the computer on which the package runs and the time the package starts. You can view the information that is contained in a system variable, but you cannot add to or update system variables.

You can also create custom variables for use in packages, containers, tasks, transformations, and precedence constraints. Custom variables can be created in the User namespace or a namespace of your choice. Custom variables can be used in the expressions that the For Loop container, the Derived Column transformation, the Conditional Split transformation, and precedence constraints may contain. For more information, see Verwenden von Variablen in Paketen.

Every container in the SSIS object model has a Variables collection. This collection is accessible to each child of the container. A variable is accessed from the collection by using its name or its index. The Variables collection on a container represents an aggregation of the variables in the collection of its parent. The Variables collection of the Package class is visible to all objects in the package, providing a globally visible collection. Conversely, the variables contained in a task are limited in scope and visibility, and are only visible by the task.

Wichtiger HinweisWichtig

The Variables is used with the Runtime classes. If you are using data flow components (Microsoft.SqlServer.Dts.Pipeline), you may be required to use the IDTSVariables100. To know which variables collection to use, see the documentation for the object you are acquiring variables on, and verify the return value.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.