ExtendedProperty 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.
Diese Klasse enthält Elemente, die zusätzliche Informationen zu einem Paket enthalten.
public ref class ExtendedProperty sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, System::ComponentModel::IComponent
public sealed class ExtendedProperty : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, System.ComponentModel.IComponent
type ExtendedProperty = class
inherit DtsObject
interface IDTSPersist
interface IDTSName
interface IComponent
interface IDisposable
Public NotInheritable Class ExtendedProperty
Inherits DtsObject
Implements IComponent, IDisposable, IDTSName, IDTSPersist
- Vererbung
- Implementiert
Hinweise
Mit der ExtendedProperties Sammlung können benutzerdefinierte Informationen mit einem Paket gespeichert werden. Beispielsweise speichert SSIS Designer selbst Paketlayoutinformationen in erweiterten Eigenschaften. Obwohl die erweiterten Eigenschaften des Pakets zur Entwurfszeit ausgeblendet und zur Laufzeit ignoriert werden, werden sie mit dem Paket beibehalten und bieten eine bequeme Möglichkeit, benutzerdefinierte Informationen oder Metadaten an ein Paket anzufügen, um eine mögliche Verwendung durch einen automatisierten Prozess oder ein benutzerdefiniertes Tool zu ermöglichen.
Jeder ExtendedProperty hat ein Name, a Description, a DataTypeund a Value. Verwenden Sie die ExtendedProperties Eigenschaft der Package Eigenschaft, um auf die erweiterte Eigenschaftensammlung zuzugreifen, und verwenden Sie die Add-Methode der Auflistung, um eine neue erweiterte Eigenschaft hinzuzufügen.
Eigenschaften
CreationName |
Gibt die Zeichenfolge zurück, die von der Runtime-Engine zum Erstellen einer Instanz des ExtendedProperty-Objekts und zum Hinzufügen des Objekts zur ExtendedProperties-Auflistung verwendet wird. Diese Eigenschaft ist schreibgeschützt. |
DataType |
Ruft den Datentyp des Werts ab, der in dieser Instanz für das Paket gespeichert ist. Dieses Feld ist schreibgeschützt. |
Description |
Ruft die Beschreibung der in dieser Instanz gespeicherten Eigenschaft ab oder legt sie fest. |
ID |
Ruft die GUID für diese Instanz ab. |
Name |
Ruft einen Namen für die in dieser Instanz gespeicherten Elemente ab oder legt ihn fest. |
Namespace |
Ruft den Namespace ab, der diesen Informationen zugeordnet ist, oder legt ihn fest. |
Site |
Ruft die Site der Eigenschaft ab oder legt sie fest. |
Value |
Ruft den Wert für die in dieser Instanz gespeicherten Informationen ab oder legt ihn fest. |
Methoden
Dispose() |
Gibt die von der Instanz dieser Klasse verwendeten Ressourcen frei. |
Equals(Object) |
Stellt fest, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject) |
GetHashCode() |
Gibt den Hashcode für diese Instanz zurück. (Geerbt von DtsObject) |
LoadFromXML(XmlNode, IDTSEvents) |
Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode. |
SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode. |
Ereignisse
Disposed |
Fügt einen Ereignishandler hinzu, um auf das Disposed-Ereignis zu lauschen. |