WmiEventWatcherTask.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 la tâche est configurée correctement.
public:
override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult
Paramètres
- connections
- Connections
Collection Connections pour la tâche.
- variableDispenser
- VariableDispenser
Objet VariableDispenser utilisé pour le verrouillage de variables.
- events
- IDTSComponentEvents
Objet qui implémente l'interface IDTSInfoEvents pour la réception des événements.
- log
- IDTSLogging
Objet qui implémente l'interface IDTSLogging pour la journalisation des événements.
Retours
Valeur de l'objet DTSExecResult qui indique le résultat 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.
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.