IDTSDesigntimeComponent100 Interfaccia

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Definisce i metodi della fase di progettazione di un componente flusso di 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

Nell'esempio di codice seguente viene illustrato come accedere all'istanza in fase 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 in fase di progettazione per un componente e contiene metodi chiamati quando vengono modificate le proprietà e le raccolte dei componenti.ComponentMetaData Gli sviluppatori di componenti gestiti non implementano in modo esplicito questa interfaccia e usano invece la PipelineComponent classe di base, che implementa i metodi di entrambe queste interfacce.

Quando si aggiungono o si modificano componenti esistenti in un'attività flusso di dati, l'istanza in fase di progettazione di un componente deve essere usata anziché accedere direttamente ai metadati del componente. La modifica dell'oggetto ComponentMetaData ignora direttamente la possibilità del componente di convalidare e rifiutare le modifiche ai metadati e deve essere evitata. Gli sviluppatori di codice gestito accedono all'istanza in fase di progettazione di un componente e usano i metodi dell'interfaccia IDTSDesigntimeComponent100 tramite CManagedComponentWrapper.

Metodi

AcquireConnections(Object)	Stabilisce una connessione a una gestione connessione.
DeleteExternalMetadataColumn(Int32, Int32)	Elimina la colonna di metadati esterna dalla raccolta di colonne di metadati esterne nella posizione di indice specificata.
DeleteInput(Int32)	Elimina un oggetto IDTSInput100 dalla raccolta IDTSInputCollection100.
DeleteOutput(Int32)	Elimina un oggetto IDTSOutput100 dalla raccolta IDTSOutputCollection100.
DeleteOutputColumn(Int32, Int32)	Elimina un oggetto IDTSOutputColumn100 dalla raccolta IDTSOutputColumnCollection100.
DescribeRedirectedErrorCode(Int32)	Restituisce la descrizione del codice di errore specificato.
GetEnumerationCollection(String)	Restituisce l'oggetto IDTSFriendlyEnumCollection100 di un componente.
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	Inserisce una nuova colonna di metadati esterna nella raccolta di colonne di metadati esterne nella posizione di indice specificata.
InsertInput(DTSInsertPlacement, Int32)	Aggiunge un oggetto IDTSInput100 all'oggetto IDTSInputCollection100.
InsertOutput(DTSInsertPlacement, Int32)	Aggiunge un nuovo oggetto IDTSOutput100.
InsertOutputColumnAt(Int32, Int32, String, String)	Crea un nuovo oggetto IDTSOutputColumn100 e lo inserisce in IDTSOutputColumnCollection100.
MapInputColumn(Int32, Int32, Int32)	Stabilisce una relazione tra una colonna di input e una colonna di metadati esterna corrispondente.
MapOutputColumn(Int32, Int32, Int32, Boolean)	Stabilisce una relazione tra una colonna di output e una colonna di metadati esterna corrispondente.
OnDeletingInputColumn(Int32, Int32)	Chiamato quando si elimina un oggetto IDTSInputColumn100 da IDTSInputColumnCollection100.
OnInputPathAttached(Int32)	Chiamato quando un oggetto IDTSInput100 è connesso a un altro componente tramite l'interfaccia IDTSPath100.
OnInputPathDetached(Int32)	Chiamato quando viene eliminato un oggetto IDTSPath100 contenente l'oggetto IDTSInput100 specificato.
OnOutputPathAttached(Int32)	Chiamato quando un oggetto IDTSOutput100 del componente viene collegato a un componente a valle.
ProvideComponentProperties()	Inizializza l'oggetto ComponentMetaData del componente quando un componente viene aggiunto all'attività Flusso di dati.
ReinitializeMetaData()	Corregge qualsiasi errore identificato durante la convalida in fase di progettazione che causa la restituzione di VS_NEEDSNEWMETADATA da parte del componente.
ReleaseConnections()	Libera le connessioni stabilite durante AcquireConnections(Object) in fase di progettazione o di esecuzione.
SetComponentProperty(String, Object)	Assegna un valore a un oggetto IDTSCustomProperty100 di un componente.
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Imposta le proprietà del tipo di dati della colonna di metadati esterna specificata.
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	Imposta una singola proprietà di una colonna di metadati esterna.
SetInputColumnProperty(Int32, Int32, String, Object)	Assegna un valore all'oggetto IDTSCustomProperty100 di un oggetto IDTSInputColumn100.
SetInputProperty(Int32, String, Object)	Assegna un valore all'oggetto IDTSCustomProperty100 di un oggetto IDTSInput100.
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Imposta le proprietà del tipo di dati di un oggetto IDTSOutputColumn100.
SetOutputColumnProperty(Int32, Int32, String, Object)	Imposta il valore di un oggetto IDTSCustomProperty100 per un oggetto IDTSOutputColumn100.
SetOutputProperty(Int32, String, Object)	Imposta il valore di un oggetto IDTSCustomProperty100 per un oggetto IDTSOutput100.
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	Crea un oggetto IDTSInputColumn100 nell'oggetto IDTSInputColumnCollection100 del componente e imposta la proprietà UsageType della colonna.
Validate()	Verifica che il componente sia configurato correttamente.