ConnectionManagerBase.Validate(IDTSInfoEvents) Méthode

Définition

Valide la connexion et retourne une énumération qui indique la réussite ou l'échec.

public:
 virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents);
public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents);
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.DTSExecResult
Public Overridable Function Validate (infoEvents As IDTSInfoEvents) As DTSExecResult

Paramètres

infoEvents
IDTSInfoEvents

Objet qui implémente l'interface d'événements IDTSInfoEvents pour déclencher des erreurs, des avertissements ou des messages d'information.

Retours

Énumération DTSExecResult.

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 ne se connecte pas aux sources de données pour valider les connexions. Toutefois, il garantit que les champs obligatoires sont remplis et contiennent les valeurs appropriées. Les champs validés diffèrent selon l’objet en cours de validation.

L’utilisation principale est 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 lorsque Package 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 substituée dans les 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 à