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.
Vérifie que le composant est configuré correctement.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRetours
Valeur de l'énumération DTSValidationStatus qui indique l'état du composant.
- Attributs
Remarques
La Validate méthode 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 le modifier IDTSComponentMetaData100 pendant Validate.
Chaque composant a des exigences différentes pour la 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 le nombre attendu.
Vérifiez que tous les IDTSCustomProperty100 objets continuent d’exister et contiennent les valeurs correctes.
Vérifiez que chaque IDTSInputColumn100 objet dans ses IDTSInputColumnCollection100 références un objet existant IDTSOutputColumn100 dans un composant en amont.
Si le composant utilise une connexion, vérifiez que l’élément IDTSRuntimeConnection100 est spécifié et que celui-ci ConnectionManager existe dans le package.
Les composants doivent fournir des commentaires aux utilisateurs en cas d’échec de la validation. Les commentaires sont fournis par le biais des FireError méthodes et FireWarning par la DTSValidationStatus valeur de retour. Les appels aux méthodes et FireWarning aux FireError méthodes s’affichent dans la fenêtre Liste des tâches dans SQL Server Data Tools (SSDT) et doivent fournir aux utilisateurs des conseils sur l’échec de validation. Parmi les quatre valeurs de l’énumération DTSValidationStatus , indique uniquement VS_ISVALID la 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.
| État | Description |
|---|---|
| VS_ISBROKEN | Indique que le composant n’est pas configuré correctement. L’utilisateur doit apporter des modifications pour ComponentMetaData 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 ReinitializeMetaData méthode. Le concepteur SSIS invite les utilisateurs à se réparer quand la valeur d’énumération est VS_NEEDSNEWMETADATA. Ensuite, le concepteur appelle la ReinitializeMetaData méthode. |
| VS_ISCORRUPT | Indique que l’élément ComponentMetaData est endommagé et ne peut pas être réparé par un appel à la ReinitializeMetaData méthode ou par des modifications du composant. |
Lorsque la propriété de la tâche de flux de données est true, les DelayValidation appels au moment du design à la méthode sont éliminés et la méthode est appelée avant l’exécution du composant à la Validate place.