CManagedComponentWrapper Schnittstelle

Definition

Konfiguriert die Eigenschaften und Spaltensammlungen einer Komponente.

public interface class CManagedComponentWrapper : Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSDesigntimeComponent100
[System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))]
[System.Runtime.InteropServices.Guid("B7EBC995-699A-4067-A34C-40FAF745C987")]
public interface CManagedComponentWrapper : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSDesigntimeComponent100
[System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))]
[System.Runtime.InteropServices.Guid("E1ACC72B-14CE-4A91-B45F-E87773C1ABB5")]
public interface CManagedComponentWrapper : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSDesigntimeComponent100
[System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))]
[System.Runtime.InteropServices.Guid("1C0F2743-58D4-4663-9BC0-06B4D19B51A7")]
public interface CManagedComponentWrapper : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSDesigntimeComponent100
[<System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))>]
[<System.Runtime.InteropServices.Guid("B7EBC995-699A-4067-A34C-40FAF745C987")>]
type CManagedComponentWrapper = interface
    interface IDTSDesigntimeComponent100
[<System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))>]
[<System.Runtime.InteropServices.Guid("E1ACC72B-14CE-4A91-B45F-E87773C1ABB5")>]
type CManagedComponentWrapper = interface
    interface IDTSDesigntimeComponent100
[<System.Runtime.InteropServices.CoClass(typeof(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass))>]
[<System.Runtime.InteropServices.Guid("1C0F2743-58D4-4663-9BC0-06B4D19B51A7")>]
type CManagedComponentWrapper = interface
    interface IDTSDesigntimeComponent100
Public Interface CManagedComponentWrapper
Implements IDTSDesigntimeComponent100
Abgeleitet
Attribute
Implementiert

Beispiele

Das folgende Codebeispiel zeigt, wie man programmatisch eine Komponente zu einer Datenflussaufgabe hinzufügt und eine Instanz der Design-Time-Schnittstelle erstellt.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Pipeline.Wrapper;  

namespace Microsoft.Samples.SqlServer.Dts  
{  
    class CreateComponent  
    {  
         [STAThread]  
        static void Main(string[] args)  
        {  
            // Create the package.  
            Package p = new Package();  

            // Add the data flow task to the package.  
            MainPipe dataFlowTask = ((TaskHost)p.Executables.Add("DTS.Pipeline.1")).InnerObject as MainPipe;  

            if (dataFlowTask != null)  
            {  
                // Add a component to the data flow task.  
                IDTSComponentMetaData100 metaData = dataFlowTask.ComponentMetaDataCollection.New();  

                // Set the class id of the component.  
                metaData.ComponentClassID = "";  

                // Create an instance of the component.  
                CManagedComponentWrapper wrapper = metaData.Instantiate();  

                // Initialize the component by calling ProvideComponentProperties.  
                wrapper.ProvideComponentProperties();  
            }  
        }  
    }  
}  

Hinweise

Die repräsentiert CManagedComponentWrapper die Schnittstelle von IDTSDesigntimeComponent100 , die bei der Designzeit-Modifikation einer Datenflusskomponente verwendet wird. CManagedComponentWrapper wird verwendet, um die Eigenschaften und Spaltensammlungen einer Datenflusskomponente während der Entwurfszeit zu konfigurieren. Obwohl die Metadaten einer Komponente direkt modifiziert werden können, sollte dies vermieden werden, da dies die Fähigkeit der Komponente umgeht, Änderungen an ihren Metadaten zu validieren. Eine Instanz von CManagedComponentWrapper wird erstellt, indem die Methode Instantiate der Schnittstelle IDTSComponentMetaData100 einer Komponente aufgerufen wird.

Die von der Schnittstelle definierten Methoden und Eigenschaften sind sowohl auf der CManagedComponentWrapperClass als auch auf den Typen IDTSDesigntimeComponent100 sichtbar.

Methoden

Name Beschreibung
AcquireConnections(Object)

Stellt eine Verbindung zu einem Verbindungsmanager her.

(Geerbt von IDTSDesigntimeComponent100)
DeleteExternalMetadataColumn(Int32, Int32)

Löscht die Spalte externe Metadaten im angegebenen Index aus der Sammlung der externen Metadatenspalten.

(Geerbt von IDTSDesigntimeComponent100)
DeleteInput(Int32)

Löscht ein IDTSInput100 Objekt aus der IDTSInputCollection100 Sammlung.

(Geerbt von IDTSDesigntimeComponent100)
DeleteOutput(Int32)

Löscht ein IDTSOutput100 Objekt aus der IDTSOutputCollection100 Sammlung.

(Geerbt von IDTSDesigntimeComponent100)
DeleteOutputColumn(Int32, Int32)

Löscht ein IDTSOutputColumn100 Objekt aus der IDTSOutputColumnCollection100 Sammlung.

(Geerbt von IDTSDesigntimeComponent100)
DescribeRedirectedErrorCode(Int32)

Gibt die Beschreibung des angegebenen Fehlercodes zurück.

(Geerbt von IDTSDesigntimeComponent100)
GetEnumerationCollection(String)

Gibt die von IDTSFriendlyEnumCollection100 einer Komponente zurück.

(Geerbt von IDTSDesigntimeComponent100)
InsertExternalMetadataColumnAt(Int32, Int32, String, String)

Fügt eine neue externe Metadaten-Spalte in die Sammlung der externen Metadatenspalten im angegebenen Index ein.

(Geerbt von IDTSDesigntimeComponent100)
InsertInput(DTSInsertPlacement, Int32)

Fügt ein IDTSInput100IDTSInputCollection100Objekt zum .

(Geerbt von IDTSDesigntimeComponent100)
InsertOutput(DTSInsertPlacement, Int32)

Fügt ein neues IDTSOutput100 -Objekt hinzu.

(Geerbt von IDTSDesigntimeComponent100)
InsertOutputColumnAt(Int32, Int32, String, String)

Erstellt ein neues IDTSOutputColumn100 Objekt und fügt es in die IDTSOutputColumnCollection100ein.

(Geerbt von IDTSDesigntimeComponent100)
MapInputColumn(Int32, Int32, Int32)

stellt eine Beziehung zwischen einer Eingabespalte und einer entsprechenden externen Metadatenspalte her.

(Geerbt von IDTSDesigntimeComponent100)
MapOutputColumn(Int32, Int32, Int32, Boolean)

Stellt eine Beziehung zwischen einer Ausgabespalte und einer entsprechenden externen Metadatenspalte her.

(Geerbt von IDTSDesigntimeComponent100)
OnDeletingInputColumn(Int32, Int32)

Gerufen, wenn ein IDTSInputColumn100 Objekt aus dem gelöscht wird IDTSInputColumnCollection100.

(Geerbt von IDTSDesigntimeComponent100)
OnInputPathAttached(Int32)

Wird aufgerufen, wenn ein IDTSInput100 Objekt über die Schnittstelle IDTSPath100 mit einer anderen Komponente verbunden ist.

(Geerbt von IDTSDesigntimeComponent100)
OnInputPathDetached(Int32)

Wird aufgerufen, wenn ein IDTSPath100 Objekt, das das angegebene IDTSInput100 Objekt enthält, gelöscht wird.

(Geerbt von IDTSDesigntimeComponent100)
OnOutputPathAttached(Int32)

Wird aufgerufen, wenn ein IDTSOutput100 Objekt der Komponente an eine nachgeschaltete Komponente angeschlossen ist.

(Geerbt von IDTSDesigntimeComponent100)
ProvideComponentProperties()

Initialisiert die ComponentMetaData der Komponente, wenn eine Komponente erstmals zur Datenflussaufgabe hinzugefügt wird.

(Geerbt von IDTSDesigntimeComponent100)
ReinitializeMetaData()

Behebt alle während der Design-Validierung festgestellten Fehler, die dazu führen, dass die Komponente zurückgibt VS_NEEDSNEWMETADATA.

(Geerbt von IDTSDesigntimeComponent100)
ReleaseConnections()

Befreit die Verbindungen, die entweder AcquireConnections(Object) zur Entwurfszeit oder zur Laufzeit hergestellt wurden.

(Geerbt von IDTSDesigntimeComponent100)
SetComponentProperty(String, Object)

Weist einem IDTSCustomProperty100 Wert von einer Komponente zu.

(Geerbt von IDTSDesigntimeComponent100)
SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)

Legt die Datentypeigenschaften der angegebenen externen Metadaten-Spalte fest.

(Geerbt von IDTSDesigntimeComponent100)
SetExternalMetadataColumnProperty(Int32, Int32, String, Object)

Setzt eine individuelle Eigenschaft einer externen Metadaten-Spalte.

(Geerbt von IDTSDesigntimeComponent100)
SetInputColumnProperty(Int32, Int32, String, Object)

Weist dem von einem IDTSCustomProperty100IDTSInputColumn100 Objekt einen Wert zu.

(Geerbt von IDTSDesigntimeComponent100)
SetInputProperty(Int32, String, Object)

Weist dem von einem IDTSCustomProperty100IDTSInput100 Objekt einen Wert zu.

(Geerbt von IDTSDesigntimeComponent100)
SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32)

Setzt die Datentypeigenschaften eines IDTSOutputColumn100 Objekts.

(Geerbt von IDTSDesigntimeComponent100)
SetOutputColumnProperty(Int32, Int32, String, Object)

Setzt den Wert von an IDTSCustomProperty100 für ein IDTSOutputColumn100 Objekt.

(Geerbt von IDTSDesigntimeComponent100)
SetOutputProperty(Int32, String, Object)

Setzt den Wert von an IDTSCustomProperty100 für ein IDTSOutput100 Objekt.

(Geerbt von IDTSDesigntimeComponent100)
SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)

Erstellt ein IDTSInputColumn100 Objekt in der IDTSInputColumnCollection100 der Komponente und setzt die UsageType Eigenschaft der Spalte.

(Geerbt von IDTSDesigntimeComponent100)
Validate()

Überprüft, dass die Komponente korrekt konfiguriert ist.

(Geerbt von IDTSDesigntimeComponent100)

Gilt für: