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("0058874E-E037-4BA9-920C-349773B5351A")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
public interface IDTSDesigntimeComponent100[<System.Runtime.InteropServices.Guid("0058874E-E037-4BA9-920C-349773B5351A")>]
[<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.
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
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();
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 des 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. Durch das direkte Ändern von ComponentMetaData wird die Fähigkeit der Komponente umgangen, Änderungen an ihren Metadaten zu überprüfen und abzulehnen, und es sollte vermieden werden. Entwickler mit verwaltetem Code greifen auf die Entwurfszeitinstanz einer Komponente zu und verwenden die Methoden der IDTSDesigntimeComponent100-Schnittstelle über .CManagedComponentWrapper