IDTSDesigntimeComponent100 Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
public interface class IDTSDesigntimeComponent100[System.Runtime.InteropServices.Guid("FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
public interface IDTSDesigntimeComponent100[<System.Runtime.InteropServices.Guid("FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
type IDTSDesigntimeComponent100 = interfacePublic Interface IDTSDesigntimeComponent100- Abgeleitet
- Attribute
Beispiele
Das folgende Codebeispiel zeigt, wie man auf die Design-Time-Instanz einer Komponente zugreift.
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
Hinweise
Diese Schnittstelle ist eine von zwei Schnittstellen, die von Datenflusskomponenten implementiert werden; IDTSRuntimeComponent100 ist das andere. Diese Schnittstelle definiert die Designzeit-Schnittstelle für eine Komponente und enthält Methoden, die aufgerufen werden, wenn die Komponenteneigenschaften und Sammlungen der ComponentMetaData geändert werden. Managed-Component-Entwickler implementieren diese Schnittstelle nicht explizit, sondern verwenden stattdessen die PipelineComponent-Basisklasse, die die Methoden beider Schnittstellen implementiert.
Beim programmatischen Hinzufügen oder Ändern bestehender Komponenten in einer Datenflussaufgabe sollte die Design-Instanz einer Komponente verwendet werden, anstatt direkt auf die Komponentenmetadaten zuzugreifen. Die direkte Änderung der ComponentMetaData umgeht die Möglichkeit der Komponente, Änderungen an ihren Metadaten zu validieren und abzulehnen, und sollte vermieden werden. Managed-Code-Entwickler greifen auf die Design-Time-Instanz einer Komponente auf und nutzen die Methoden der IDTSDesigntimeComponent100-Schnittstelle über den CManagedComponentWrapper.