IDTSDesigntimeComponent100 Interfaccia

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Definisce i metodi a tempo di progettazione di un componente di flusso dati scritto in 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

Derivato

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass

Attributi

GuidAttribute TypeLibTypeAttribute

Esempio

Il seguente esempio di codice dimostra come accedere all'istanza in tempo di progettazione di un 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  

Commenti

Questa interfaccia è una delle due interfacce implementate dai componenti del flusso di dati; IDTSRuntimeComponent100 è l'altro. Questa interfaccia definisce l'interfaccia a tempo di progettazione per un componente e contiene metodi che vengono chiamati quando le proprietà e le collezioni dei ComponentMetaData componenti vengono modificate. Gli sviluppatori di componenti gestiti non implementano esplicitamente questa interfaccia, ma utilizzano invece la PipelineComponent classe base, che implementa i metodi di entrambe queste interfacce.

Quando si aggiungono o modifichi in modo programmativo componenti esistenti in un compito di flusso dati, dovrebbe essere utilizzata l'istanza a tempo di progettazione di un componente invece di accedere direttamente ai metadati del componente. Modificare direttamente la ComponentMetaData modifica bypassa la capacità del componente di validare e rifiutare modifiche ai suoi metadati, e dovrebbe essere evitato. Gli sviluppatori di codice gestito accedono all'istanza in tempo di progettazione di un componente e utilizzano i metodi dell'interfaccia IDTSDesigntimeComponent100 , tramite il CManagedComponentWrapperfile .

Metodi

Nome	Descrizione
AcquireConnections(Object)	Stabilisce una connessione con un connection manager.
DeleteExternalMetadataColumn(Int32, Int32)	Elimina la colonna dei metadati esterni nell'indice specificato dalla raccolta delle colonne di metadati esterne.
DeleteInput(Int32)	Elimina un IDTSInput100 oggetto dalla IDTSInputCollection100 collezione.
DeleteOutput(Int32)	Elimina un IDTSOutput100 oggetto dalla IDTSOutputCollection100 collezione.
DeleteOutputColumn(Int32, Int32)	Elimina un IDTSOutputColumn100 oggetto dalla IDTSOutputColumnCollection100 collezione.
DescribeRedirectedErrorCode(Int32)	Restituisce la descrizione del codice di errore specificato.
GetEnumerationCollection(String)	Restituisce il IDTSFriendlyEnumCollection100 di un componente.
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	Inserisce una nuova colonna di metadati esterni nella collezione di colonne di metadati esterni all'indice specificato.
InsertInput(DTSInsertPlacement, Int32)	Aggiunge un IDTSInput100 oggetto all'oggetto IDTSInputCollection100.
InsertOutput(DTSInsertPlacement, Int32)	Aggiunge un nuovo IDTSOutput100 oggetto .
InsertOutputColumnAt(Int32, Int32, String, String)	Crea un nuovo IDTSOutputColumn100 oggetto e lo inserisce nel IDTSOutputColumnCollection100file .
MapInputColumn(Int32, Int32, Int32)	Stabilisce una relazione tra una colonna di input e una corrispondente colonna di metadati esterna.
MapOutputColumn(Int32, Int32, Int32, Boolean)	Stabilisce una relazione tra una colonna di output e una corrispondente colonna esterna di metadati.
OnDeletingInputColumn(Int32, Int32)	Chiamato quando si elimina un IDTSInputColumn100 oggetto dal IDTSInputColumnCollection100file .
OnInputPathAttached(Int32)	Chiamato quando un IDTSInput100 oggetto è collegato a un altro componente tramite l'interfaccia IDTSPath100 .
OnInputPathDetached(Int32)	Chiamato quando un IDTSPath100 oggetto che contiene l'oggetto specificato IDTSInput100 viene eliminato.
OnOutputPathAttached(Int32)	Chiamato quando un IDTSOutput100 oggetto del componente è collegato a un componente a valle.
ProvideComponentProperties()	Inizializza il ComponentMetaData componente quando un componente viene aggiunto per la prima volta al compito di flusso dati.
ReinitializeMetaData()	Corregge eventuali errori identificati durante la validazione in tempo di progettazione che portano il componente a restituire VS_NEEDSNEWMETADATA.
ReleaseConnections()	Libera le connessioni stabilite durante AcquireConnections(Object) sia al tempo di progettazione che a tempo di esecuzione.
SetComponentProperty(String, Object)	Assegna un valore a un IDTSCustomProperty100 di un componente.
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Imposta le proprietà del tipo di dato della colonna di metadati esterni specificata.
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	Imposta una proprietà individuale di una colonna di metadati esterna.
SetInputColumnProperty(Int32, Int32, String, Object)	Assegna un valore al IDTSCustomProperty100 di un IDTSInputColumn100 oggetto.
SetInputProperty(Int32, String, Object)	Assegna un valore al IDTSCustomProperty100 di un IDTSInput100 oggetto.
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Imposta le proprietà del tipo di dato di un IDTSOutputColumn100 oggetto.
SetOutputColumnProperty(Int32, Int32, String, Object)	Stabilisce il valore di un IDTSCustomProperty100 per un IDTSOutputColumn100 oggetto.
SetOutputProperty(Int32, String, Object)	Stabilisce il valore di un IDTSCustomProperty100 per un IDTSOutput100 oggetto.
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	Crea un IDTSInputColumn100 oggetto nel IDTSInputColumnCollection100 componente e imposta la UsageType proprietà della colonna.
Validate()	Verifica che il componente sia configurato correttamente.