IDTSDesigntimeComponent100 Schnittstelle

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:: Microsoft.SqlServer.DTSPipelineWrap.dll

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.

Definiert die Entwurfszeitmethoden einer in C++ und COM geschriebenen Datenflusskomponente.

public interface class IDTSDesigntimeComponent100

[System.Runtime.InteropServices.Guid("B7EBC995-699A-4067-A34C-40FAF745C987")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
public interface IDTSDesigntimeComponent100

[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
[System.Runtime.InteropServices.Guid("E1ACC72B-14CE-4A91-B45F-E87773C1ABB5")]
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")]
public interface IDTSDesigntimeComponent100

[<System.Runtime.InteropServices.Guid("B7EBC995-699A-4067-A34C-40FAF745C987")>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
type IDTSDesigntimeComponent100 = interface

[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
[<System.Runtime.InteropServices.Guid("E1ACC72B-14CE-4A91-B45F-E87773C1ABB5")>]
type IDTSDesigntimeComponent100 = interface

[<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

Im folgenden Codebeispiel wird veranschaulicht, wie auf die Entwurfszeitinstanz einer Komponente zugegriffen wird.

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 der andere. Diese Schnittstelle definiert die Entwurfszeitschnittstelle für eine Komponente und enthält Methoden, die aufgerufen werden, wenn die Komponenteneigenschaften und -auflistungen ComponentMetaData geändert werden. Verwaltete Komponentenentwickler implementieren diese Schnittstelle nicht explizit und verwenden stattdessen die PipelineComponent Basisklasse, die die Methoden beider Schnittstellen implementiert.

Wenn Sie vorhandene Komponenten programmgesteuert in einer Datenflussaufgabe hinzufügen oder ändern, sollte die Entwurfszeitinstanz einer Komponente verwendet werden, anstatt direkt auf die Komponentenmetadaten zuzugreifen. Durch die direkte Umgehung der ComponentMetaData Fähigkeit der Komponente, Änderungen an den Metadaten zu überprüfen und abzulehnen, sollte vermieden werden. Verwalteter Codeentwickler greifen auf die Entwurfszeitinstanz einer Komponente zu und verwenden die Methoden der IDTSDesigntimeComponent100 Schnittstelle über die CManagedComponentWrapper.

Methoden

AcquireConnections(Object)	Stellt eine Verbindung mit einem Verbindungs-Manager her.
DeleteExternalMetadataColumn(Int32, Int32)	Löscht die externe Metadatenspalte am angegebenen Index aus der Auflistung externer Metadatenspalten.
DeleteInput(Int32)	Löscht ein IDTSInput100-Objekt aus der IDTSInputCollection100-Auflistung.
DeleteOutput(Int32)	Löscht ein IDTSOutput100-Objekt aus der IDTSOutputCollection100-Auflistung.
DeleteOutputColumn(Int32, Int32)	Löscht ein IDTSOutputColumn100-Objekt aus der IDTSOutputColumnCollection100-Auflistung.
DescribeRedirectedErrorCode(Int32)	Gibt die Beschreibung des angegebenen Fehlercodes zurück.
GetEnumerationCollection(String)	Gibt die IDTSFriendlyEnumCollection100 der Komponente zurück.
InsertExternalMetadataColumnAt(Int32, Int32, String, String)	Fügt eine neue externe Metadatenspalte am angegebenen Index in die Auflistung externer Metadatenspalten ein.
InsertInput(DTSInsertPlacement, Int32)	Fügt IDTSInput100 ein IDTSInputCollection100-Objekt hinzu.
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 IDTSOutputColumnCollection100 ein.
MapInputColumn(Int32, Int32, Int32)	Legt eine Beziehung zwischen einer Eingabespalte und einer entsprechenden externen Metadatenspalte fest.
MapOutputColumn(Int32, Int32, Int32, Boolean)	Legt eine Beziehung zwischen einer Ausgabespalte und einer entsprechenden externen Metadatenspalte fest.
OnDeletingInputColumn(Int32, Int32)	Wird aufgerufen, wenn ein IDTSInputColumn100-Objekt aus IDTSInputColumnCollection100 gelöscht wird.
OnInputPathAttached(Int32)	Wird aufgerufen, wenn ein IDTSInput100-Objekt über die IDTSPath100-Schnittstelle mit einer anderen Komponente verbunden wird.
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 Downstreamkomponente angefügt wird.
ProvideComponentProperties()	Initialisiert die ComponentMetaData der Komponente, wenn eine Komponente dem Datenflusstask erstmalig hinzugefügt wird.
ReinitializeMetaData()	Behebt alle während der Entwurfszeitüberprüfung identifizierten Fehler, die dazu führen, dass die Komponente VS_NEEDSNEWMETADATA zurückgibt.
ReleaseConnections()	Gibt die zur Entwurfszeit oder Laufzeit während AcquireConnections(Object) hergestellten Verbindungen frei.
SetComponentProperty(String, Object)	Weist einer IDTSCustomProperty100 einer Komponente einen Wert zu.
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Legt die Datentypeigenschaften der angegebenen externen Metadatenspalte fest.
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)	Legt eine einzelne Eigenschaft einer externen Metadatenspalte fest.
SetInputColumnProperty(Int32, Int32, String, Object)	Weist der IDTSCustomProperty100 eines IDTSInputColumn100-Objekts einen Wert zu.
SetInputProperty(Int32, String, Object)	Weist der IDTSCustomProperty100 eines IDTSInput100-Objekts einen Wert zu.
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)	Legt die Datentypeigenschaften eines IDTSOutputColumn100-Objekts fest.
SetOutputColumnProperty(Int32, Int32, String, Object)	Legt den Wert von IDTSCustomProperty100 für ein IDTSOutputColumn100-Objekt fest.
SetOutputProperty(Int32, String, Object)	Legt den Wert von IDTSCustomProperty100 für ein IDTSOutput100-Objekt fest.
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)	Erstellt ein IDTSInputColumn100-Objekt in der IDTSInputColumnCollection100 der Komponente und legt die UsageType-Eigenschaft der Spalte fest.
Validate()	Überprüft, ob die Komponente ordnungsgemäß konfiguriert ist.

Gilt für: