LogProviderBase.Validate(IDTSInfoEvents) 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.
Appelée pour vérifier que le module fournisseur d'informations est correctement configuré.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultParamètres
- events
- IDTSInfoEvents
Interface IDTSInfoEvents utilisée pour déclencher des événements d'information pendant l'exécution du package.
Retours
Valeur de la structure DTSExecResult qui indique la réussite ou l'échec de la validation.
Exemples
L’exemple de code suivant montre comment valider des objets à l’aide de la Validate méthode de l’objet Package .
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
Remarques
La Validate méthode examine les propriétés et les paramètres pour des inexactitudes ou des paramètres incorrects. La méthode ne touche pas les données ou se connecte aux sources de données pour valider les connexions. Toutefois, il garantit que les champs requis sont renseignés et contiennent des valeurs appropriées. Les champs validés diffèrent selon l’objet en cours de validation. Pour les fournisseurs de journaux, la Validate méthode vérifie que la ConfigString propriété est correctement configurée et que toutes les autres propriétés ou paramètres requis du fournisseur de journaux sont définis comme prévu. Les fournisseurs de journaux qui nécessitent des connexions à des sources de données externes le font via l’utilisation d’objets ConnectionManager . La ConfigString propriété est souvent utilisée pour contenir le nom ou l’ID d’une ConnectionManager collection Connections .
Dans ce cas, Validate vérifiez que la ConnectionManagerConfigString propriété spécifiée existe dans le package.
Si Failure elle est retournée, l’exécution du package est annulée.
L’utilisation principale est lors de Validate l’écriture d’une tâche personnalisée. La Validate méthode est appelée par le Concepteur SSIS lorsqu’une tâche est supprimée sur l’aire de conception et à nouveau, potentiellement plusieurs fois, lorsque les propriétés sont définies. Toutefois, dans le code, la Validate méthode sur des objets individuels n’est pas couramment utilisée, car il est recommandé d’appeler la Validate méthode sur le Package moment où vous devez valider des objets. Toutefois, la méthode est disponible sur des objets individuels si vous trouvez une circonstance unique où elle est nécessaire.
La Validate méthode est remplacée par des tâches personnalisées, soit pour la validation de l’objet lorsqu’il est utilisé dans le Concepteur SSIS, soit lorsqu’il est appelé par du code. Pour plus d’informations sur l’écriture de la Validate méthode pour une tâche personnalisée, consultez Codage d’une tâche personnalisée.