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 en 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 = interfacePublic Interface IDTSDesigntimeComponent100- Dérivé
- Attributs
Exemples
L’exemple de code suivant montre comment accéder à l’instance au moment du design 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 est l’autre. Cette interface définit l’interface au moment du design pour un composant et contient des méthodes appelées lorsque les propriétés et collections du composant sont ComponentMetaData modifiées. Les développeurs de composants managés n’implémentent pas explicitement cette interface et utilisent plutôt la PipelineComponent classe de base, qui implémente les méthodes de ces deux interfaces.
Lorsque vous ajoutez ou modifiez des composants existants dans une tâche de flux de données, l’instance au moment de la conception d’un composant doit être utilisée au lieu d’accéder directement aux métadonnées du composant. La ComponentMetaData modification directe contourne la capacité du composant à valider et à rejeter les modifications apportées à ses métadonnées et doit être évitée. Les développeurs de code managé accèdent à l’instance au moment de la conception d’un composant et utilisent les méthodes de l’interface IDTSDesigntimeComponent100 , via le CManagedComponentWrapper.
Méthodes
| AcquireConnections(Object) |
Établit une connexion à un gestionnaire de connexions. |
| DeleteExternalMetadataColumn(Int32, Int32) |
Supprime la colonne de métadonnées externes à l'index spécifié de la collection de colonnes de métadonnées externes. |
| DeleteInput(Int32) |
Supprime un objet IDTSInput100 de la collection IDTSInputCollection100. |
| DeleteOutput(Int32) |
Supprime un objet IDTSOutput100 de la collection IDTSOutputCollection100. |
| DeleteOutputColumn(Int32, Int32) |
Supprime un objet IDTSOutputColumn100 de la collection IDTSOutputColumnCollection100. |
| DescribeRedirectedErrorCode(Int32) |
Retourne la description du code d'erreur spécifié. |
| GetEnumerationCollection(String) |
Retourne l'objet IDTSFriendlyEnumCollection100 d'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 objet IDTSInput100 au IDTSInputCollection100. |
| InsertOutput(DTSInsertPlacement, Int32) |
Ajoute un nouvel objet IDTSOutput100. |
| InsertOutputColumnAt(Int32, Int32, String, String) |
Crée un objet IDTSOutputColumn100 et l'insère dans la collection IDTSOutputColumnCollection100. |
| MapInputColumn(Int32, Int32, Int32) |
Établit une relation entre une colonne d'entrée et une colonne de métadonnées externes correspondante. |
| MapOutputColumn(Int32, Int32, Int32, Boolean) |
Établit une relation entre une colonne de sortie et une colonne de métadonnées externes correspondante. |
| OnDeletingInputColumn(Int32, Int32) |
Appelée lors de la suppression d'un objet IDTSInputColumn100 de l'objet IDTSInputColumnCollection100. |
| OnInputPathAttached(Int32) |
Appelée lorsqu'un objet IDTSInput100 est connecté à un autre composant via l'interface IDTSPath100. |
| OnInputPathDetached(Int32) |
Appelé en cas de suppression d'un objet IDTSPath100 qui contient l'objet IDTSInput100 spécifié. |
| OnOutputPathAttached(Int32) |
Appelé lorsqu'un objet IDTSOutput100 du composant est attaché à un composant en aval. |
| ProvideComponentProperties() |
Initialise la propriété ComponentMetaData du composant 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 pendant la validation au moment de la conception qui entraînent le retour de l'objet VS_NEEDSNEWMETADATA du composant. |
| ReleaseConnections() |
Libère les connexions établies par la méthode AcquireConnections(Object) au moment de la conception ou de l'exécution. |
| SetComponentProperty(String, Object) |
Affecte une valeur à un objet IDTSCustomProperty100 d'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 externes spécifiée. |
| SetExternalMetadataColumnProperty(Int32, Int32, String, Object) |
Définit une propriété individuelle d'une colonne de métadonnées externes. |
| SetInputColumnProperty(Int32, Int32, String, Object) |
Affecte une valeur à l'objet IDTSCustomProperty100 d'un objet IDTSInputColumn100. |
| SetInputProperty(Int32, String, Object) |
Affecte une valeur à l'objet IDTSCustomProperty100 d'un objet IDTSInput100. |
| SetOutputColumnDataTypeProperties(Int32, Int32, DataType, Int32, Int32, Int32, Int32) |
Définit les propriétés du type de données d'un objet IDTSOutputColumn100. |
| SetOutputColumnProperty(Int32, Int32, String, Object) |
Définit la valeur d'un objet IDTSCustomProperty100 pour un objet IDTSOutputColumn100. |
| SetOutputProperty(Int32, String, Object) |
Définit la valeur d'un objet IDTSCustomProperty100 pour un objet IDTSOutput100. |
| SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType) |
Crée un objet IDTSInputColumn100 dans la collection IDTSInputColumnCollection100 du composant et définit la propriété UsageType de la colonne. |
| Validate() |
Vérifie que le composant est configuré correctement. |