IDTSDesigntimeComponent100 Interface

Definição

Namespace:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Define os métodos de tempo de design de um componente de fluxo de dados gravado em C++ e 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

Derivado

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass

Atributos

GuidAttribute TypeLibTypeAttribute

Exemplos

O exemplo de código a seguir demonstra como acessar a instância de tempo de design de um componente.

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  

Comentários

Essa interface é uma das duas interfaces implementadas por componentes de fluxo de dados; IDTSRuntimeComponent100 é o outro. Essa interface define a interface de tempo de design para um componente e contém métodos que são chamados quando as propriedades e coleções do ComponentMetaData componente são modificadas. Os desenvolvedores de componentes gerenciados não implementam explicitamente essa interface e, em vez disso, usam a PipelineComponent classe base, que implementa os métodos dessas duas interfaces.

Ao adicionar ou modificar componentes existentes programaticamente em uma tarefa de fluxo de dados, a instância de tempo de design de um componente deve ser usada em vez de acessar os metadados do componente diretamente. Modificar o ComponentMetaData componente ignora diretamente a capacidade do componente de validar e rejeitar alterações em seus metadados e deve ser evitado. Os desenvolvedores de código gerenciado acessam a instância de tempo de design de um componente e usam os métodos da IDTSDesigntimeComponent100 interface por meio do CManagedComponentWrapper.

Métodos

AcquireConnections(Object)	Estabelece uma conexão com um gerenciador de conexões.
DeleteExternalMetadataColumn(Int32, Int32)	Exclui a coluna de metadados externa no índice especificado da coleção de colunas de metadados externas.
DeleteInput(Int32)	Exclui um objeto IDTSInput100 da coleção IDTSInputCollection100.
DeleteOutput(Int32)	Exclui um objeto IDTSOutput100 da coleção IDTSOutputCollection100.
DeleteOutputColumn(Int32, Int32)	Exclui um objeto IDTSOutputColumn100 da coleção IDTSOutputColumnCollection100.
DescribeRedirectedErrorCode(Int32)	Retorna a descrição do código de erro especificado.
GetEnumerationCollection(String)	Retorna o IDTSFriendlyEnumCollection100 de um componente.
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	Insere uma nova coluna de metadados externa na coleção de colunas de metadados externas no índice especificado.
InsertInput(DTSInsertPlacement, Int32)	Adiciona um objeto IDTSInput100 ao IDTSInputCollection100.
InsertOutput(DTSInsertPlacement, Int32)	Adiciona um novo objeto IDTSOutput100.
InsertOutputColumnAt(Int32, Int32, String, String)	Cria um novo objeto IDTSOutputColumn100 e o insere no IDTSOutputColumnCollection100.
MapInputColumn(Int32, Int32, Int32)	Estabelece uma relação entre uma coluna de entrada e uma coluna de metadados externa correspondente.
MapOutputColumn(Int32, Int32, Int32, Boolean)	Estabelece uma relação entre uma coluna de saída e uma coluna de metadados externa correspondente.
OnDeletingInputColumn(Int32, Int32)	Chamado ao excluir um objeto IDTSInputColumn100 do IDTSInputColumnCollection100.
OnInputPathAttached(Int32)	Chamado quando um objeto IDTSInput100 é conectado a outro componente por meio da interface IDTSPath100.
OnInputPathDetached(Int32)	Chamado quando um objeto IDTSPath100 que contém o objeto IDTSInput100 especificado é excluído.
OnOutputPathAttached(Int32)	Chamado quando um objeto IDTSOutput100 do componente está anexado a um componente downstream.
ProvideComponentProperties()	Inicializa o ComponentMetaData do componente quando um componente é adicionado pela primeira vez à tarefa de fluxo de dados.
ReinitializeMetaData()	Corrige qualquer erro identificado durante a validação tempo de design em que o componente retorna VS_NEEDSNEWMETADATA.
ReleaseConnections()	Libera as conexões estabelecidas durante AcquireConnections(Object) em tempo de design ou de execução.
SetComponentProperty(String, Object)	Atribui um valor a um IDTSCustomProperty100 de um componente.
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Define as propriedades do tipo de dados da coluna de metadados externa.
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	Define uma propriedade individual de uma coluna de metadados externa.
SetInputColumnProperty(Int32, Int32, String, Object)	Atribui um valor ao IDTSCustomProperty100 de um objeto IDTSInputColumn100.
SetInputProperty(Int32, String, Object)	Atribui um valor ao IDTSCustomProperty100 de um objeto IDTSInput100.
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Define as propriedades do tipo de dados de um objeto IDTSOutputColumn100.
SetOutputColumnProperty(Int32, Int32, String, Object)	Obtém o valor de um IDTSCustomProperty100 para um objeto IDTSOutputColumn100.
SetOutputProperty(Int32, String, Object)	Obtém o valor de um IDTSCustomProperty100 para um objeto IDTSOutput100.
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	Cria um objeto IDTSInputColumn100 no IDTSInputColumnCollection100 do componente e define a propriedade UsageType da coluna.
Validate()	Verifica se o componente está configurado corretamente.