Partager via


Executable.Validate(Connections, Variables, IDTSEvents, IDTSLogging) Méthode

Définition

Vérifiez que l'exécutable s'exécutera correctement en validant toutes ses dépendances et d'autres éléments avant son exécution. Le composant qui implémente cette méthode est le composant en cours de validation.

public:
 abstract 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 abstract 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);
abstract member 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.DTSExecResult
Public MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResult

Paramètres

connections
Connections

Collection Connections.

variables
Variables

Collection Variables.

events
IDTSEvents

Interface IDTSEvents utilisée pour déclencher des événements.

log
IDTSLogging

Interface IDTSLogging.

Retours

Retourne une valeur de l'énumération DTSExecResult qui indique si la validation du fichier exécutable a réussi, a échoué ou s'est soldée par un autre état.

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.

S’applique à