IDTSDesigntimeComponent100 接口

定义

命名空间:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

程序集:

Microsoft.SqlServer.DTSPipelineWrap.dll

定义用 C++ 和 COM 编写的数据流组件的设计时方法。

public interface class IDTSDesigntimeComponent100

[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
[System.Runtime.InteropServices.Guid("1C0F2743-58D4-4663-9BC0-06B4D19B51A7")]
public interface IDTSDesigntimeComponent100

[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
[<System.Runtime.InteropServices.Guid("1C0F2743-58D4-4663-9BC0-06B4D19B51A7")>]
type IDTSDesigntimeComponent100 = interface

Public Interface IDTSDesigntimeComponent100

派生

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass

属性

GuidAttribute TypeLibTypeAttribute

示例

下面的代码示例演示如何访问组件的设计时实例。

Package p = new Package();  
MainPipe dataFlow = ((TaskHost)p.Executables.Add("DTS.Pipeline")).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("DTS.Pipeline"), TaskHost).InnerObject, MainPipe)   
Dim md As IDTSComponentMetaData100 = dataFlow.ComponentMetaDataCollection.New   
md.ComponentClassID = "DTSAdapter.OleDbSource"   
Dim wrp As CManagedComponentWrapper = md.Instantiate   
wrp.ProvideComponentProperties  

注解

此接口是数据流组件实现的两个接口之一; IDTSRuntimeComponent100 是另一种。 此接口定义组件的设计时接口，并包含修改组件属性和集合 ComponentMetaData 时调用的方法。 托管组件开发人员不会显式实现此接口，而是使用 PipelineComponent 基类，该基类实现这两个接口的方法。

在数据流任务中以编程方式添加或修改现有组件时，应使用组件的设计时实例，而不是直接访问组件元数据。 修改 ComponentMetaData 直接绕过组件验证和拒绝对其元数据的更改的能力，并应避免。 托管代码开发人员通过 访问组件的设计时实例，并使用接口CManagedComponentWrapper的方法IDTSDesigntimeComponent100。

方法

AcquireConnections(Object)	建立与连接管理器的连接。
DeleteExternalMetadataColumn(Int32, Int32)	从外部元数据列的集合中删除指定索引处的外部元数据列。
DeleteInput(Int32)	从 IDTSInput100 集合中删除 IDTSInputCollection100 对象。
DeleteOutput(Int32)	从 IDTSOutput100 集合中删除 IDTSOutputCollection100 对象。
DeleteOutputColumn(Int32, Int32)	从 IDTSOutputColumn100 集合中删除 IDTSOutputColumnCollection100 对象。
DescribeRedirectedErrorCode(Int32)	返回指定错误代码的说明。
GetEnumerationCollection(String)	返回组件的 IDTSFriendlyEnumCollection100。
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	将新的外部元数据列插入到位于指定索引处的外部元数据列的集合中。
InsertInput(DTSInsertPlacement, Int32)	将 IDTSInput100 对象添加到 IDTSInputCollection100。
InsertOutput(DTSInsertPlacement, Int32)	添加新的 IDTSOutput100 对象。
InsertOutputColumnAt(Int32, Int32, String, String)	创建一个新的 IDTSOutputColumn100 对象并将其插入到 IDTSOutputColumnCollection100。
MapInputColumn(Int32, Int32, Int32)	在输入列与相应的外部元数据列之间建立关系。
MapOutputColumn(Int32, Int32, Int32, Boolean)	在输出列与相应的外部元数据列之间建立关系。
OnDeletingInputColumn(Int32, Int32)	当从 IDTSInputColumn100 中删除 IDTSInputColumnCollection100 对象时调用。
OnInputPathAttached(Int32)	当 IDTSInput100 对象通过 IDTSPath100 接口连接到其他组件时调用。
OnInputPathDetached(Int32)	当删除包含指定 IDTSPath100 对象的 IDTSInput100 对象时调用。
OnOutputPathAttached(Int32)	当组件的 IDTSOutput100 对象附加到下游组件时调用。
ProvideComponentProperties()	当首先将组件添加到数据流任务时，初始化组件的 ComponentMetaData。
ReinitializeMetaData()	修复在设计时验证过程中确定的导致组件返回 VS_NEEDSNEWMETADATA 的任何错误。
ReleaseConnections()	释放在设计时或运行时在 AcquireConnections(Object) 过程中建立的连接。
SetComponentProperty(String, Object)	向组件的 IDTSCustomProperty100 赋值。
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	设置指定外部元数据列的数据类型属性。
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	设置外部元数据列的单个属性。
SetInputColumnProperty(Int32, Int32, String, Object)	向 IDTSCustomProperty100 对象的 IDTSInputColumn100 赋值。
SetInputProperty(Int32, String, Object)	向 IDTSCustomProperty100 对象的 IDTSInput100 赋值。
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	设置 IDTSOutputColumn100 对象的数据类型属性。
SetOutputColumnProperty(Int32, Int32, String, Object)	设置 IDTSCustomProperty100 对象的 IDTSOutputColumn100 的值。
SetOutputProperty(Int32, String, Object)	设置 IDTSCustomProperty100 对象的 IDTSOutput100 的值。
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	在组件的 IDTSInputColumn100 中创建一个 IDTSInputColumnCollection100 对象，并设置该列的 UsageType 属性。
Validate()	验证该组件已正确配置。