PipelineComponent.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.
Important
Cette API n’est pas conforme CLS.
Vérifie que le composant est correctement configuré.
public:
virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate();[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Overridable Function Validate () As DTSValidationStatusRetours
Une valeur issue de l’énumération DTSValidationStatus qui indique le statut du composant.
- Attributs
Remarques
La Validate méthode est surchargé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 devraient pas modifier son ComponentMetaData pendant Validate.
L’implémentation de la classe de base vérifie Validate l’existence d’objets IDTSInputColumn100 dont LineageID la propriété ne correspond pas à celle LineageID de un IDTSOutputColumn100 d’un composant en amont. Les développeurs de composants devraient étendre la fonctionnalité de la classe Validate de base en effectuant des vérifications supplémentaires sur le ComponentMetaDatafichier . 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 possède le nombre attendu d’objets IDTSInput100 et IDTSOutput100 .
Vérifiez que les IDTSCustomProperty100 objets continuent d’exister et contiennent les bonnes valeurs.
Si le composant utilise une connexion, il doit vérifier que le IDTSRuntimeConnection100 est spécifié et que le ConnectionManager existe dans le package.
Les composants doivent fournir un retour aux utilisateurs lorsque la validation échoue. Les retours sont fournis via les FireError méthodes et FireWarning par la valeur de DTSValidationStatus retour. Les appels vers FireError et FireWarning sont affichés dans la fenêtre de liste d’erreurs 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 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 le concepteur SSIS.
| État | Description |
|---|---|
| VS_ISBROKEN | Indique que le composant n’est pas mal configuré, mais que les modifications de l’utilisateur ComponentMetaData résolvent les problèmes. |
| VS_NEEDSNEWMETADATA | Indique que les erreurs de validation peuvent être corrigées par le composant dans sa mise en œuvre de la ReinitializeMetaData méthode. SSIS Designer avertira les utilisateurs que le composant peut se réparer lui-même lorsque VS_NEEDSNEWMETADATA, et qu’il est ensuite ReinitializeMetaData appelé. |
| VS_ISCORRUPT | Indique que le ComponentMetaData est corrompu et ne peut pas être réparé par un appel vers ReinitializeMetaData ou par des modifications du composant. |
Lorsque la DelayValidation propriété de la tâche de flux de données est true, les appels au temps de conception à Validate sont éliminés et la méthode est appelée avant l’exécution du composant.
Pour plus d’informations, consultez Validation d’un composant de flux de données.