IDTSDesigntimeComponent100 Schnittstelle

Definition

Namespace:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Definiert die Design-Time-Methoden einer Datenflusskomponente, die in C++ und COM geschrieben ist.

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

Abgeleitet

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper

Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass

Attribute

GuidAttribute TypeLibTypeAttribute

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 Komponenten Eigenschaften und Sammlungen von geändert ComponentMetaData werden. Managed-Component-Entwickler implementieren diese Schnittstelle nicht explizit, sondern verwenden stattdessen die Basisklasse PipelineComponent , 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. Eine direkte Änderung umgeht die ComponentMetaData 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 Schnittstelle IDTSDesigntimeComponent100 über die CManagedComponentWrapper.

Methoden

Name	Beschreibung
AcquireConnections(Object)	Stellt eine Verbindung zu einem Verbindungsmanager her.
DeleteExternalMetadataColumn(Int32, Int32)	Löscht die Spalte externe Metadaten im angegebenen Index aus der Sammlung der externen Metadatenspalten.
DeleteInput(Int32)	Löscht ein IDTSInput100 Objekt aus der IDTSInputCollection100 Sammlung.
DeleteOutput(Int32)	Löscht ein IDTSOutput100 Objekt aus der IDTSOutputCollection100 Sammlung.
DeleteOutputColumn(Int32, Int32)	Löscht ein IDTSOutputColumn100 Objekt aus der IDTSOutputColumnCollection100 Sammlung.
DescribeRedirectedErrorCode(Int32)	Gibt die Beschreibung des angegebenen Fehlercodes zurück.
GetEnumerationCollection(String)	Gibt die von IDTSFriendlyEnumCollection100 einer Komponente zurück.
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	Fügt eine neue externe Metadaten-Spalte in die Sammlung der externen Metadatenspalten im angegebenen Index ein.
InsertInput(DTSInsertPlacement, Int32)	Fügt ein IDTSInput100IDTSInputCollection100Objekt zum .
InsertOutput(DTSInsertPlacement, Int32)	Fügt ein neues IDTSOutput100 -Objekt hinzu.
InsertOutputColumnAt(Int32, Int32, String, String)	Erstellt ein neues IDTSOutputColumn100 Objekt und fügt es in die IDTSOutputColumnCollection100ein.
MapInputColumn(Int32, Int32, Int32)	stellt eine Beziehung zwischen einer Eingabespalte und einer entsprechenden externen Metadatenspalte her.
MapOutputColumn(Int32, Int32, Int32, Boolean)	Stellt eine Beziehung zwischen einer Ausgabespalte und einer entsprechenden externen Metadatenspalte her.
OnDeletingInputColumn(Int32, Int32)	Gerufen, wenn ein IDTSInputColumn100 Objekt aus dem gelöscht wird IDTSInputColumnCollection100.
OnInputPathAttached(Int32)	Wird aufgerufen, wenn ein IDTSInput100 Objekt über die Schnittstelle IDTSPath100 mit einer anderen Komponente verbunden ist.
OnInputPathDetached(Int32)	Wird aufgerufen, wenn ein IDTSPath100 Objekt, das das angegebene IDTSInput100 Objekt enthält, gelöscht wird.
OnOutputPathAttached(Int32)	Wird aufgerufen, wenn ein IDTSOutput100 Objekt der Komponente an eine nachgeschaltete Komponente angeschlossen ist.
ProvideComponentProperties()	Initialisiert die ComponentMetaData der Komponente, wenn eine Komponente erstmals zur Datenflussaufgabe hinzugefügt wird.
ReinitializeMetaData()	Behebt alle während der Design-Validierung festgestellten Fehler, die dazu führen, dass die Komponente zurückgibt VS_NEEDSNEWMETADATA.
ReleaseConnections()	Befreit die Verbindungen, die entweder AcquireConnections(Object) zur Entwurfszeit oder zur Laufzeit hergestellt wurden.
SetComponentProperty(String, Object)	Weist einem IDTSCustomProperty100 Wert von einer Komponente zu.
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Legt die Datentypeigenschaften der angegebenen externen Metadaten-Spalte fest.
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	Setzt eine individuelle Eigenschaft einer externen Metadaten-Spalte.
SetInputColumnProperty(Int32, Int32, String, Object)	Weist dem von einem IDTSCustomProperty100IDTSInputColumn100 Objekt einen Wert zu.
SetInputProperty(Int32, String, Object)	Weist dem von einem IDTSCustomProperty100IDTSInput100 Objekt einen Wert zu.
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Setzt die Datentypeigenschaften eines IDTSOutputColumn100 Objekts.
SetOutputColumnProperty(Int32, Int32, String, Object)	Setzt den Wert von an IDTSCustomProperty100 für ein IDTSOutputColumn100 Objekt.
SetOutputProperty(Int32, String, Object)	Setzt den Wert von an IDTSCustomProperty100 für ein IDTSOutput100 Objekt.
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	Erstellt ein IDTSInputColumn100 Objekt in der IDTSInputColumnCollection100 der Komponente und setzt die UsageType Eigenschaft der Spalte.
Validate()	Überprüft, dass die Komponente korrekt konfiguriert ist.