DtsContainer.Validate(Connections, Variables, IDTSEvents, IDTSLogging) 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.
Permet au conteneur de déterminer s’il contient des paramètres invalides qui l’empêcheront d’exécuter correctement.
public:
override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::Variables ^ variables, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ 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.Variables variables, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.Variables * Microsoft.SqlServer.Dts.Runtime.IDTSEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Overrides Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResultParamètres
- connections
- Connections
La Connections collecte pour le conteneur.
- events
- IDTSEvents
Une IDTSEvents 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 Validate tâche personnalisée.