IDTSDesigntimeComponent100.Validate Méthode
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.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2012::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRetours
Une valeur issue de l’énumération DTSValidationStatus qui indique le statut du composant.
- Attributs
Remarques
La méthode Validation est implémentée par les développeurs de composants pour vérifier que le composant est correctement configuré. Il est appelé à plusieurs reprises lors de la conception du package, et une fois avant l’exécution du composant. Les composants ne doivent pas modifier son IDTSComponentMetaData100 pendant la validation.
Chaque composant a des exigences différentes pour une validation réussie, mais la liste suivante présente certains des éléments courants qui doivent être validés.
Vérifiez que le composant dispose du nombre attendu d’objets IDTSInput100 et IDTSOutput100.
Vérifiez que les objets IDTSCustomProperty100 continuent d’exister et contiennent les valeurs correctes.
Vérifiez que chaque objet IDTSInputColumn100 dans son IDTSInputColumnCollection100 fait référence à un objet IDTSOutputColumn100 existant dans un composant amont.
Si le composant utilise une connexion, vérifiez que IDTSRuntimeConnection100 est spécifié et que le ConnectionManager existe dans le package.
Les composants doivent fournir un retour aux utilisateurs lorsque la validation échoue. Le retour d’information est fourni via les méthodes FireError et FireWarning ainsi que par la valeur de retour DTSValidationStatus. Les appels vers les méthodes FireError et FireWarning sont affichés dans la fenêtre de la liste des tâches dans SQL Server Data Tools (SSDT), et doivent fournir aux utilisateurs des indications sur l’échec de validation. Parmi les quatre valeurs de l’énumération DTSValidationStatus, seule VS_ISVALID indique une validation réussie. Les trois autres valeurs indiquent différents niveaux de défaillance. Le tableau suivant décrit les valeurs de défaillance dans l’énumération et leur interprétation par SSIS Designer.
| État | Description |
|---|---|
| VS_ISBROKEN | Indique que le composant n’est pas configuré correctement. L’utilisateur doit apporter des modifications au ComponentMetaData pour résoudre les problèmes. |
| VS_NEEDSNEWMETADATA | Indique que les erreurs de validation peuvent être corrigées par le composant dans son implémentation de la méthode ReinitializeMetaData. Le concepteur SSIS indiquera aux utilisateurs que le composant peut se réparer lui-même lorsque la valeur d’énumération est VS_NEEDSNEWMETADATA. Ensuite, le concepteur appellera la méthode ReinitializeMetaData. |
| VS_ISCORRUPT | Indique que le ComponentMetaData est corrompu et ne peut pas être réparé par un appel à la méthode ReinitializeMetaData ou par des modifications du composant. |
Lorsque la propriété de validation de délai de la tâche de flux de données est vraie, les appels au moment de conception vers la méthode de validation sont supprimés, et la méthode est appelée avant l’exécution du composant.