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
Im folgenden Codebeispiel wird der Zugriff auf die Entwurfszeitinstanz einer Komponente veranschaulicht.
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 die andere. Diese Schnittstelle definiert die Entwurfszeitschnittstelle für eine Komponente und enthält Methoden, die aufgerufen werden, wenn die Komponenteneigenschaften und Auflistungen der ComponentMetaData geändert werden. Entwickler verwalteter Komponenten implementieren diese Schnittstelle nicht explizit und verwenden stattdessen die PipelineComponent-Basisklasse, die die Methoden beider Schnittstellen implementiert.
Beim programmgesteuerten Hinzufügen oder Ändern vorhandener Komponenten in einem Datenflusstask sollte die Entwurfszeitinstanz einer Komponente verwendet werden, anstatt direkt auf die Komponentenmetadaten zuzugreifen. Das direkte Ändern von ComponentMetaData umgeht die Fähigkeit der Komponente, Änderungen an ihren Metadaten zu überprüfen und abzulehnen, und sollte vermieden werden. Entwickler von verwaltetem Code greifen auf die Entwurfszeitinstanz einer Komponente zu und verwenden die Methoden der IDTSDesigntimeComponent100-Schnittstelle über CManagedComponentWrapper.