IDTSDesigntimeComponent100 Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit les méthodes de conception d’un composant de flux de données écrit en C++ et COM.
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
- Dérivé
- Attributs
Exemples
L’exemple de code suivant montre comment accéder à l’instance de conception d’un composant.
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
Remarques
Cette interface est l’une des deux interfaces implémentées par les composants de flux de données ; IDTSRuntimeComponent100 c’est l’autre. Cette interface définit l’interface au moment de conception d’un composant et contient des méthodes qui sont appelées lorsque les propriétés et collections des ComponentMetaData composants sont modifiées. Les développeurs de composants managés n’implémentent pas explicitement cette interface, et utilisent à la place la PipelineComponent classe de base, qui implémente les méthodes de ces deux interfaces.
Lors de l’ajout ou de la modification programmatique de composants existants dans une tâche de flux de données, l’instance au moment de conception d’un composant doit être utilisée au lieu d’accéder directement aux métadonnées du composant. Modifier directement le ComponentMetaData composant contourne la capacité du composant à valider et rejeter les modifications de ses métadonnées, et doit être évité. Les développeurs de code managé accèdent à l’instance de conception d’un composant et utilisent les méthodes de l’interface IDTSDesigntimeComponent100 , via le CManagedComponentWrapperfichier .
Méthodes
| Nom | Description |
|---|---|
| AcquireConnections(Object) |
Établit une connexion avec un gestionnaire de connexion. |
| DeleteExternalMetadataColumn(Int32, Int32) |
Supprime la colonne de métadonnées externes à l’index spécifié de la collection des colonnes de métadonnées externes. |
| DeleteInput(Int32) |
Supprime un IDTSInput100 objet de la IDTSInputCollection100 collection. |
| DeleteOutput(Int32) |
Supprime un IDTSOutput100 objet de la IDTSOutputCollection100 collection. |
| DeleteOutputColumn(Int32, Int32) |
Supprime un IDTSOutputColumn100 objet de la IDTSOutputColumnCollection100 collection. |
| DescribeRedirectedErrorCode(Int32) |
Retourne la description du code d’erreur spécifié. |
| GetEnumerationCollection(String) |
Retourne le IDTSFriendlyEnumCollection100 de un composant. |
| InsertExternalMetadataColumnAt(Int32, Int32, String, String) |
Insère une nouvelle colonne de métadonnées externes dans la collection de colonnes de métadonnées externes à l’index spécifié. |
| InsertInput(DTSInsertPlacement, Int32) |
Ajoute un IDTSInput100 objet au IDTSInputCollection100. |
| InsertOutput(DTSInsertPlacement, Int32) |
Ajoute un nouvel IDTSOutput100 objet. |
| InsertOutputColumnAt(Int32, Int32, String, String) |
Crée un nouvel IDTSOutputColumn100 objet et l’insère dans le IDTSOutputColumnCollection100fichier . |
| MapInputColumn(Int32, Int32, Int32) |
Établit une relation entre une colonne d’entrée et une colonne externe de métadonnées correspondante. |
| MapOutputColumn(Int32, Int32, Int32, Boolean) |
Établit une relation entre une colonne de sortie et une colonne externe de métadonnées correspondante. |
| OnDeletingInputColumn(Int32, Int32) |
Appelé lors de la suppression d’un IDTSInputColumn100 objet du IDTSInputColumnCollection100fichier . |
| OnInputPathAttached(Int32) |
Appelé lorsqu’un IDTSInput100 objet est connecté à un autre composant via l’interface IDTSPath100 . |
| OnInputPathDetached(Int32) |
Appelé lorsqu’un IDTSPath100 objet contenant l’objet spécifié IDTSInput100 est supprimé. |
| OnOutputPathAttached(Int32) |
Appelé lorsqu’un IDTSOutput100 objet du composant est attaché à un composant en aval. |
| ProvideComponentProperties() |
Initialise le ComponentMetaData de la composante lorsqu’un composant est ajouté pour la première fois à la tâche de flux de données. |
| ReinitializeMetaData() |
Corrige toutes les erreurs identifiées lors de la validation au moment de la conception qui entraînent le retour VS_NEEDSNEWMETADATAdu composant . |
| ReleaseConnections() |
Libère les connexions établies pendant AcquireConnections(Object) qu’elles soient au moment de la conception ou à l’exécution. |
| SetComponentProperty(String, Object) |
Attribue une valeur à un IDTSCustomProperty100 de un composant. |
| SetExternalMetadataColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32) |
Définit les propriétés de type de données de la colonne de métadonnées externe spécifiée. |
| SetExternalMetadataColumnProperty(Int32, Int32, String, Object) |
Définit une propriété individuelle d’une colonne de métadonnées externe. |
| SetInputColumnProperty(Int32, Int32, String, Object) |
Attribue une valeur à un IDTSCustomProperty100IDTSInputColumn100 objet. |
| SetInputProperty(Int32, String, Object) |
Attribue une valeur à un IDTSCustomProperty100IDTSInput100 objet. |
| SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32) |
Définit les propriétés du type de données d’un IDTSOutputColumn100 objet. |
| SetOutputColumnProperty(Int32, Int32, String, Object) |
Fixe la valeur de un IDTSCustomProperty100 pour un IDTSOutputColumn100 objet. |
| SetOutputProperty(Int32, String, Object) |
Fixe la valeur de un IDTSCustomProperty100 pour un IDTSOutput100 objet. |
| SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType) |
Crée un IDTSInputColumn100 objet dans le IDTSInputColumnCollection100 de la composante et définit la UsageType propriété de la colonne. |
| Validate() |
Vérifie que le composant est correctement configuré. |