LogProviderBase.Validate(IDTSInfoEvents) 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.
J’ai appelé pour confirmer que le fournisseur de journal est correctement configuré.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);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.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultParamètres
- events
- IDTSInfoEvents
Une interface utilisée pour lancer des événements informationnels lors de l’exécution du IDTSInfoEvents paquet.
Retours
Une valeur de la DTSExecResult structure qui indique le succès ou l’échec 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é. Pour les fournisseurs de journaux, la Validate méthode vérifie que la ConfigString propriété est correctement configurée et que toutes les autres propriétés ou réglages requis du fournisseur de journaux sont définis comme prévu. Les fournisseurs de journaux qui nécessitent des connexions à des sources de données externes le font par l’utilisation d’objets ConnectionManager . La ConfigString propriété est souvent utilisée pour détenir le nom ou l’identifiant d’un ConnectionManager membre de la Connections collection.
Dans ce cas, Validate il faut vérifier que ce que ConnectionManager spécifié dans la ConfigString propriété existe dans le paquet.
Si Failure elle est retournée, l’exécution du paquet est annulée.
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.