Executable.Validate(Connections, Variables, IDTSEvents, IDTSLogging) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Vergewissern Sie sich, dass die ausführbare Datei erfolgreich ausgeführt wird, indem Sie alle Abhängigkeiten und anderen Elemente vor der Ausführung überprüfen. Die Komponente, die diese Methode implementiert, ist die überprüfte Komponente.
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.DTSExecResultPublic MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResultParameter
- connections
- Connections
Eine Connections-Auflistung.
- events
- IDTSEvents
Eine IDTSEvents-Schnittstelle zum Auslösen von Ereignissen.
- log
- IDTSLogging
Eine IDTSLogging-Schnittstelle.
Gibt zurück
Gibt einen Wert aus der DTSExecResult-Enumeration zurück, der die erfolgreiche oder fehlerhafte Überprüfung der ausführbaren Datei bzw. einen anderen Status angibt.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Objekte mithilfe Validate der Methode des Package Objekts überprüft werden.
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
Hinweise
Die Validate Methode überprüft Eigenschaften und Einstellungen für Ungenauigkeiten oder falsche Einstellungen. Die Methode berührt keine Daten oder stellt eine Verbindung mit Datenquellen her, um Verbindungen zu überprüfen. Sie stellt jedoch sicher, dass erforderliche Felder ausgefüllt und entsprechende Werte enthalten. Die Felder, die überprüft werden, unterscheiden sich je nachdem, welche Objekte überprüft werden.
Die primäre Verwendung Validate ist beim Schreiben einer benutzerdefinierten Aufgabe. Die Validate Methode wird vom SSIS-Designer aufgerufen, wenn eine Aufgabe auf die Entwurfsoberfläche und erneut, möglicherweise mehrmals, wenn Eigenschaften festgelegt werden. Im Code wird die Validate Methode für einzelne Objekte jedoch nicht häufig verwendet, da sie empfohlen wird, die Methode beim Package Überprüfen von Validate Objekten aufzurufen. Die Methode ist jedoch für einzelne Objekte verfügbar, wenn Sie einen einzigartigen Umstand finden, in dem sie benötigt wird.
Die Validate Methode wird in benutzerdefinierten Vorgängen außer Kraft gesetzt, entweder für die Überprüfung des Objekts, wenn sie im SSIS-Designer verwendet werden, oder wenn sie von Code aufgerufen wird. Weitere Informationen zum Schreiben der Validate Methode für einen benutzerdefinierten Vorgang finden Sie unter Codieren einer benutzerdefinierten Aufgabe.