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 해당 메타데이터에 대한 변경 내용의 유효성을 검사하고 거부하는 구성 요소의 기능이 무시되며 피해야 합니다. 관리 코드 개발자는 구성 요소의 디자인 타임 인스턴스에 액세스하고 인터페이스의 메서드를 IDTSDesigntimeComponent100 통해 CManagedComponentWrapper사용합니다.

메서드

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()	구성 요소가 제대로 구성되었는지 확인합니다.