Поделиться через

  • Статья

Интерфейс IDTSDesigntimeComponent100

Defines the design-time methods of a data flow component written in C++ and COM.

Пространство имен:  Microsoft.SqlServer.Dts.Pipeline.Wrapper
Сборка:  Microsoft.SqlServer.DTSPipelineWrap (в Microsoft.SqlServer.DTSPipelineWrap.dll)

Синтаксис

'Декларация
<GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")> _
Public Interface IDTSDesigntimeComponent100
'Применение
Dim instance As IDTSDesigntimeComponent100

[GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")]
public interface IDTSDesigntimeComponent100

[GuidAttribute(L"B13097E5-4465-4A9C-BB74-FFC8F8E30760")]
public interface class IDTSDesigntimeComponent100

[<GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")>]
type IDTSDesigntimeComponent100 =  interface end

public interface IDTSDesigntimeComponent100

Тип IDTSDesigntimeComponent100 обеспечивает доступ к следующим элементам.

Методы

  Имя Описание
Открытый метод AcquireConnections Establishes a connection to a connection manager.
Открытый метод DeleteExternalMetadataColumn Deletes the external metadata column at the specified index from the collection of external metadata columns.
Открытый метод DeleteInput Deletes an IDTSInput100 object from the IDTSInputCollection100 collection.
Открытый метод DeleteOutput Deletes an IDTSOutput100 object from the IDTSOutputCollection100 collection.
Открытый метод DeleteOutputColumn Deletes an IDTSOutputColumn100 object from the IDTSOutputColumnCollection100 collection.
Открытый метод DescribeRedirectedErrorCode Returns the description of the specified error code.
Открытый метод GetEnumerationCollection Returns the IDTSFriendlyEnumCollection100 of a component.
Открытый метод InsertExternalMetadataColumnAt Inserts a new external metadata column into the collection of external metadata columns at the specified index.
Открытый метод InsertInput Adds an IDTSInput100 object to the IDTSInputCollection100.
Открытый метод InsertOutput Adds a new IDTSOutput100 object.
Открытый метод InsertOutputColumnAt Creates a new IDTSOutputColumn100 object and inserts it into the IDTSOutputColumnCollection100.
Открытый метод MapInputColumn Establishes a relationship between an input column and a corresponding external metadata column.
Открытый метод MapOutputColumn Establishes a relationship between an output column and a corresponding external metadata column.
Открытый метод OnDeletingInputColumn Called when deleting an IDTSInputColumn100 object from the IDTSInputColumnCollection100.
Открытый метод OnInputPathAttached Called when an IDTSInput100 object is connected to another component through the IDTSPath100 interface.
Открытый метод OnInputPathDetached Called when an IDTSPath100 object that contains the specified IDTSInput100 object is deleted.
Открытый метод OnOutputPathAttached Called when an IDTSOutput100 object of the component is attached to a downstream component.
Открытый метод ProvideComponentProperties Initializes the ComponentMetaData of the component when a component is first added to the data flow task.
Открытый метод ReinitializeMetaData Fixes any errors identified during design-time validation that result in the component returning VS_NEEDSNEWMETADATA.
Открытый метод ReleaseConnections Frees the connections established during AcquireConnections at either design time or run time.
Открытый метод SetComponentProperty Assigns a value to an IDTSCustomProperty100 of a component.
Открытый метод SetExternalMetadataColumnDataTypeProperties Sets the data type properties of the specified external metadata column.
Открытый метод SetExternalMetadataColumnProperty Sets an individual property of an external metadata column.
Открытый метод SetInputColumnProperty Assigns a value to the IDTSCustomProperty100 of an IDTSInputColumn100 object.
Открытый метод SetInputProperty Assigns a value to the IDTSCustomProperty100 of an IDTSInput100 object.
Открытый метод SetOutputColumnDataTypeProperties Sets the data type properties of an IDTSOutputColumn100 object.
Открытый метод SetOutputColumnProperty Sets the value of an IDTSCustomProperty100 for an IDTSOutputColumn100 object.
Открытый метод SetOutputProperty Sets the value of an IDTSCustomProperty100 on an IDTSOutput100 object.
Открытый метод SetUsageType Creates an IDTSInputColumn100 object in the IDTSInputColumnCollection100 of the component and sets the UsageType property of the column.
Открытый метод Validate Verifies that the component is correctly configured.

В начало

Замечания

This interface is one of two interfaces implemented by data flow components; IDTSRuntimeComponent100 is the other. This interface defines the design-time interface for a component and contains methods that are called when the component properties and collections of the ComponentMetaData are modified. Managed component developers do not explicitly implement this interface, and instead use the PipelineComponent base class, which implements the methods of both these interfaces.

When programmatically adding or modifying existing components in a data flow task, the design-time instance of a component should be used instead of accessing the component metadata directly. Modifying the ComponentMetaData directly bypasses the ability of the component to validate and reject changes to its metadata, and should be avoided. Managed code developers access the design-time instance of a component, and use the methods of the IDTSDesigntimeComponent100 interface, through the CManagedComponentWrapper.

Примеры

The following code example demonstrates how to access the design-time instance of a component.

Package p = new Package();
MainPipe dataFlow = ((TaskHost)p.Executables.Add("SSIS.Pipeline.2")).InnerObject as MainPipe;

IDTSComponentMetaData100 md = dataFlow.ComponentMetaDataCollection.New();
md.ComponentClassID = "DTSAdapter.OleDbSource";
CManagedComponentWrapper wrp = md.Instantiate();
wrp.ProvideComponentProperties();

Dim p As Package = New Package 
Dim dataFlow As MainPipe = CType(CType(p.Executables.Add("SSIS.Pipeline.2"), TaskHost).InnerObject, MainPipe) 
Dim md As IDTSComponentMetaData100 = dataFlow.ComponentMetaDataCollection.New 
md.ComponentClassID = "DTSAdapter.OleDbSource" 
Dim wrp As CManagedComponentWrapper = md.Instantiate 
wrp.ProvideComponentProperties