Freigeben über


Variable Klasse

Definition

Stellt eine Variable für ein Paket, einen Task oder einen Container dar. Diese Klasse kann nicht vererbt werden.

public ref class Variable sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, System::ComponentModel::IComponent
public sealed class Variable : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, System.ComponentModel.IComponent
type Variable = class
    inherit DtsObject
    interface IDTSPersist
    interface IDTSName
    interface IDTSPropertiesProvider
    interface IDTSPackagePath
    interface IDTSExecutionPath
    interface IComponent
    interface IDisposable
Public NotInheritable Class Variable
Inherits DtsObject
Implements IComponent, IDisposable, IDTSExecutionPath, IDTSName, IDTSPackagePath, IDTSPersist, IDTSPropertiesProvider
Vererbung
Variable
Implementiert

Hinweise

Variablen werden in Namespaces gruppiert, um die Unklarheit zu erhalten. Der System Namespace wird automatisch für jedes Paket erstellt und enthält schreibgeschützte Eigenschaften. Der User Namespace enthält benutzerdefinierte Eigenschaften, die Sie hinzufügen können. Sie können auch einen Namespace Ihrer Wahl erstellen, zu dem Variablen hinzugefügt werden sollen. Diese Klasse erbt von mehreren Klassen und Schnittstellen, einschließlich zwei von Visual Studio .NET Framework:

Eigenschaften

CreationName

Ruft die Zeichenfolge ab, die von der Runtime-Engine bei der Erstellung einer Instanz des Variable-Objekts angegeben wird, und fügt der Variables-Auflistung das Objekt hinzu. Diese Eigenschaft ist schreibgeschützt.

DataType

Ruft eine TypeCode-Enumeration ab, die den Datentyp der Variablen beschreibt Diese Eigenschaft ist schreibgeschützt.

Description

Ruft die Beschreibung der Variablen ab oder legt sie fest.

EvaluateAsExpression

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob die Variable einen Ausdruck enthält.

Expression

Ruft den in einer Variablen enthaltenen Ausdruck ab oder legt ihn fest.

ID

Ruft die GUID ab, die der Variablen zugewiesen ist. Dieses Feld ist schreibgeschützt.

IncludeInDebugDump

Ruft einen Wert ab, der angibt, ob der Variablenwert für eine benutzerdefinierte Variable oder Systemvariable in den Debugdumpdateien enthalten ist, oder legt ihn fest.

Name

Ruft den Namen der Variablen ab oder legt ihn fest.

Namespace

Ruft den Namespace ab, dem die Variable angehört, oder legt ihn fest.

Parent

Ruft den übergeordneten Container der Variable-Instanz ab.

Properties

Ruft eine Auflistung von DtsProperty-Objekten ab. Diese Eigenschaft ist schreibgeschützt.

QualifiedName

Ruft den vollqualifizierten Namen der Variablen, einschließlich des Namespaces, ab. Diese Eigenschaft ist schreibgeschützt.

RaiseChangedEvent

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob die Variable gekennzeichnet wurde, um das OnVariableValueChanged(DtsContainer, Variable, Boolean) Ereignis zu auslösen, wenn sich der Wert der Variablen ändert.

ReadOnly

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, dass die Variable schreibgeschützt ist und dessen Wert nicht geändert werden kann.

Site

Ruft die Site der Variablen ab oder legt sie fest.

SystemVariable

Ruft einen booleschen Wert ab, der angibt, ob die Variable eine Systemvariable ist. Diese Eigenschaft ist schreibgeschützt.

Value

Ruft den der Variablen zugewiesenen Wert ab oder legt ihn fest.

Methoden

Dispose()

Diese Methode wird von der IDisposable.Dispose-Methode geerbt. Diese stellt einen Mechanismus dar, durch den ein Objekt explizit angewiesen wird, ein Cleanup auszuführen.

Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
GetExecutionPath()

Gibt den Ausführungspfad des aktuellen Variable-Objekts zurück.

GetExpression(String)

Die GetExpression(String)-Methode wird für Variable-Objekte nicht unterstützt. Verwenden Sie stattdessen die EvaluateAsExpression-Eigenschaft.

GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von DtsObject)
GetPackagePath()

Gibt den Pfad des Pakets zurück, dem die Variable angehört.

GetSensitiveValue()

Gibt den vertraulichen Variablenwert zurück.

LoadFromXML(XmlNode, IDTSEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Lädt ein im XML-Format gespeichertes Paket unter Verwendung der LoadPackage(String, IDTSEvents)-Methode.

SaveToXML(XmlDocument, XmlNode, IDTSEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Speichert ein Paket unter Verwendung der SaveToXml(String, Package, IDTSEvents)-Methode als XML-Datei.

SetExpression(String, String)

Die SetExpression(String, String)-Methode wird für Variable-Objekte nicht unterstützt. Verwenden Sie stattdessen die EvaluateAsExpression-Eigenschaft.

Ereignisse

Disposed

Fügt einen Ereignishandler hinzu, der auf das Disposed-Ereignis für die Variable lauscht.

Gilt für: