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。

方法

名稱	Description
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)	為物件的 指派一個值IDTSCustomProperty100IDTSInputColumn100。
SetInputProperty(Int32, String, Object)	為物件的 指派一個值IDTSCustomProperty100IDTSInput100。
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	設定物件的資料型態屬性 IDTSOutputColumn100 。
SetOutputColumnProperty(Int32, Int32, String, Object)	設定物件的IDTSCustomProperty100IDTSOutputColumn100值。
SetOutputProperty(Int32, String, Object)	設定物件的IDTSCustomProperty100IDTSOutput100值。
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	在元件的 中IDTSInputColumnCollection100建立IDTSInputColumn100一個物件，並設定UsageType欄位的屬性。
Validate()	驗證元件是否正確設定。