ForEachSMOEnumerator.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.
Retourne une valeur qui indique si le conteneur possède des paramètres invalides qui l’empêcheront de fonctionner 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::IDTSInfoEvents ^ 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.IDTSInfoEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult
Paramètres
- connections
- Connections
La Connections collecte pour le conteneur.
- variableDispenser
- VariableDispenser
La VariableDispenser collecte pour le conteneur.
- events
- IDTSInfoEvents
Une IDTSInfoEvents interface pour lancer des événements.
- log
- IDTSLogging
Interface IDTSLogging.
Retours
Une DTSExecResult énumération qui indique le résultat de la validation.
Exemples
L’exemple de code suivant montre comment valider des objets en utilisant 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 réglages pour détecter des inexactitudes ou des réglages incorrects. La méthode ne touche pas aux données, ni ne se connecte aux sources de données pour valider les connexions. Cependant, elle garantit que les champs requis sont remplis et contiennent des valeurs appropriées. Les champs validés diffèrent selon l’objet validé.
L’utilisation principale de Validate est lors de l’écriture d’une tâche personnalisée. La Validate méthode est appelée par le concepteur SSIS lorsqu’une tâche est déposée sur la surface de conception et, à nouveau, potentiellement plusieurs fois, lorsque des propriétés sont en cours de définition. Cependant, en 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 lorsque vous devez valider des objets. Cependant, la méthode est disponible pour des objets individuels si vous trouvez une situation particulière où elle est nécessaire.
La Validate méthode est écrasée dans les tâches personnalisées, soit pour la validation de l’objet lorsqu’elle est utilisée dans le SSIS Designer, soit lorsqu’elle est appelée par le code. Pour plus d’informations sur la rédaction de la méthode d’une tâche personnalisée, voir Codage d’uneValidate tâche personnalisée.