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 configuré correctement.
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
Valeur de l'énumération DTSValidationStatus qui indique l'état du composant.
- Attributs
Remarques
La Validate méthode est remplacé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 ComponentMetaData pendant Validate.
Implémentation de la classe de base des Validate vérifications de l’existence d’objets IDTSInputColumn100 dont LineageID la propriété ne correspond pas à LineageID l’un IDTSOutputColumn100 d’un composant en amont. Les développeurs de composants doivent étendre la fonctionnalité de classe Validate de base en effectuant des vérifications supplémentaires sur le ComponentMetaData. 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 et IDTSOutput100 le IDTSInput100 nombre attendu.
Vérifiez que tous les IDTSCustomProperty100 objets continuent d’exister et contiennent les valeurs correctes.
Si le composant utilise une connexion, il doit vérifier que celui-ci IDTSRuntimeConnection100 est spécifié et que celui-ci ConnectionManager existe dans le package.
Les composants doivent fournir des commentaires aux utilisateurs lors de l’é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 à FireError et FireWarning sont affichés dans la fenêtre Liste d’erreurs dans SQL Server Data Tools (SSDT) et doivent fournir des conseils aux utilisateurs sur l’échec de validation. Les quatre valeurs de l’énumération DTSValidationStatus indiquent uniquement VS_ISVALID la validation réussie. Les trois autres valeurs indiquent différents niveaux de défaillance. 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é de manière incorrecte, mais que les modifications apportées par l’utilisateur à la ComponentMetaData résolution des problèmes sont résolues. |
| VS_NEEDSNEWMETADATA | Indique que les erreurs de validation peuvent être corrigées par le composant dans son implémentation de la ReinitializeMetaData méthode. SSIS Designer invite les utilisateurs que le composant peut réparer lui-même quand VS_NEEDSNEWMETADATA, puis ReinitializeMetaData est appelé. |
| VS_ISCORRUPT | Indique que l’objet ComponentMetaData est endommagé et ne peut pas être réparé par un appel ou ReinitializeMetaData par des modifications du composant. |
Lorsque la propriété de la tâche de flux de données est true, les DelayValidation appels au temps de conception à Validate éliminer 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.