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.DTSValidationStatus
Public Function Validate () As DTSValidationStatus
Retours
Valeur de l’énumération DTSValidationStatus qui indique l’état du composant.
- Attributs
Remarques
La méthode Validate est implémentée par les développeurs de composants pour vérifier que le composant est correctement configuré. Il est appelé à plusieurs reprises pendant 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 fournit certains des éléments courants qui doivent être validés.
Vérifiez que le composant a le nombre attendu d’objets IDTSInput100 et IDTSOutput100.
Vérifiez que tous les objets IDTSCustomProperty100 continuent d’exister et contiennent les valeurs correctes.
Vérifiez que chaque objet IDTSInputColumn100 dans son IDTSInputColumnCollection100 référence un objet IDTSOutputColumn100 existant dans un composant en amont.
Si le composant utilise une connexion, vérifiez que l’IDTSRuntimeConnection100 est spécifié et que le ConnectionManager existe dans le package.
Les composants doivent fournir des commentaires aux utilisateurs en cas d’échec de la validation. Les commentaires sont fournis via les méthodes FireError et FireWarning et par la valeur de retour DTSValidationStatus. Les appels aux méthodes FireError et FireWarning s’affichent dans la fenêtre Liste des tâches de SQL Server Data Tools (SSDT) et doivent fournir aux utilisateurs des conseils sur l’échec de validation. Sur les quatre valeurs de l’énumération DTSValidationStatus, seule VS_ISVALID indique une validation réussie. Les trois autres valeurs indiquent différents niveaux d’échec. Le tableau suivant décrit les valeurs d’échec dans l’énumération et la façon dont elles sont interprétées par le concepteur SSIS.
Statut | Description |
---|---|
VS_ISBROKEN | Indique que le composant n’est pas configuré correctement. L’utilisateur doit apporter des modifications à 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 invite les utilisateurs à indiquer que le composant peut se réparer lui-même lorsque la valeur d’énumération est VS_NEEDSNEWMETADATA. Ensuite, le concepteur appelle la méthode ReinitializeMetaData. |
VS_ISCORRUPT | Indique que le ComponentMetaData est endommagé et ne peut pas être réparé par un appel à la méthode ReinitializeMetaData ou par des modifications apportées au composant. |
Lorsque la propriété DelayValidation de la tâche de flux de données a la valeur true, les appels au moment du design à la méthode Validate sont éliminés et la méthode est appelée avant l’exécution du composant à la place.