Variable Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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. |