ExtendedProperty Class

Article
04/26/2013

This class contains members that hold additional information about a package.

Inheritance Hierarchy

System.Object
Microsoft.SqlServer.Dts.Runtime.DtsObject
Microsoft.SqlServer.Dts.Runtime.ExtendedProperty

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

Syntax

'Declaration
Public NotInheritable Class ExtendedProperty _
    Inherits DtsObject _
    Implements IDTSPersist, IDTSName, IComponent, IDisposable
'Usage
Dim instance As ExtendedProperty

public sealed class ExtendedProperty : DtsObject, 
    IDTSPersist, IDTSName, IComponent, IDisposable

public ref class ExtendedProperty sealed : public DtsObject, 
    IDTSPersist, IDTSName, IComponent, IDisposable

[<SealedAttribute>]
type ExtendedProperty =  
    class 
        inherit DtsObject 
        interface IDTSPersist 
        interface IDTSName 
        interface IComponent 
        interface IDisposable 
    end

public final class ExtendedProperty extends DtsObject implements IDTSPersist, IDTSName, IComponent, IDisposable

The ExtendedProperty type exposes the following members.

Properties

	Name	Description
	CreationName	Returns the string that is used by the run-time engine to create an instance of the ExtendedProperty object and to add the object to the ExtendedProperties collection. This property is read-only.
	DataType	Gets the DataType of the value stored in this instance for the package. This field is read-only.
	Description	Gets or sets the description related to the property stored in this instance.
	ID	Gets the GUID for this instance.
	Name	Gets or sets a name for what is stored in this instance.
	Namespace	Gets or sets the namespace associated with this information.
	Site	Infrastructure. Gets or sets the site of the property.
	Value	Gets or sets the value for the information stored in this instance.

Top

Methods

	Name	Description
	Dispose	Releases the resources used by the instance of this class.
	Equals	Determines whether two object instances are equal. (Inherited from DtsObject.)
	GetHashCode	Returns the hash code for this instance. (Inherited from DtsObject.)
	GetType	(Inherited from Object.)
	LoadFromXML	This method is not callable by your application code. To load a package saved as .xml, use the Application.LoadPackage method
	SaveToXML	This method is not callable by your application code. To save a package as .xml, use the Application.SaveToXml method.
	ToString	(Inherited from Object.)

Top

Events

	Name	Description
	Disposed	Adds an event handler to listen to the Disposed event.

Top

Remarks

The ExtendedProperties collection lets custom information be stored with a package. For example, SSIS Designer itself stores package layout information in extended properties. Although the package extended properties of the package are hidden at design time and ignored at run time, they are persisted with the package and provide a convenient way to attach user-defined information or metadata to a package for possible use by an automated process or custom tool.

Each ExtendedProperty has a Name, a Description, a DataType, and a Value. Use the ExtendedProperties property of the Package to access its extended properties collection, and use the Add method of the collection to add a new extended property.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via