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.
Überprüfen Sie, ob die ausführbare Datei erfolgreich ausgeführt wird, indem Sie alle ihre Abhängigkeiten und andere Elemente vor der Ausführung validieren. Die Komponente, die diese Methode implementiert, ist die, die validiert wird.
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 Sammlung.
- events
- IDTSEvents
Eine Schnittstelle IDTSEvents , um Ereignisse anzusprechen.
- log
- IDTSLogging
Eine IDTSLogging-Schnittstelle.
Gibt zurück
Gibt einen Wert aus der DTSExecResult Aufzählung zurück, der den Erfolg, den Fehlschlag oder einen anderen Status bei der Validierung der ausführbaren Datei anzeigt.
Beispiele
Das folgende Codebeispiel zeigt, wie Objekte mit der Methode Validate des Package Objekts validiert werden können.
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
Hinweise
Die Methode Validate überprüft Eigenschaften und Einstellungen auf Ungenauigkeiten oder falsche Einstellungen. Die Methode berührt keine Daten und verbindet sich nicht mit Datenquellen, um Verbindungen zu validieren. Es stellt jedoch sicher, dass die erforderlichen Felder ausgefüllt werden und entsprechende Werte enthalten. Die validierten Felder unterscheiden sich je nachdem, welches Objekt validiert wird.
Der Hauptzweck Validate ist das Schreiben einer individuellen Aufgabe. Die Methode Validate wird vom SSIS-Designer aufgerufen, wenn eine Aufgabe auf die Designoberfläche gelegt wird, und erneut, möglicherweise mehrmals, wenn Eigenschaften gesetzt werden. Im Code wird die Methode Validate jedoch auf einzelnen Objekten nicht häufig verwendet, da empfohlen wird, die Validate Methode auf dem zu aufrufen Package , wenn Objekte validiert werden müssen. Die Methode ist jedoch bei einzelnen Objekten verfügbar, falls Sie eine besondere Situation finden, in der sie benötigt wird.
Die Methode Validate wird in benutzerdefinierten Aufgaben überschrieben, entweder zur Validierung des Objekts, wenn es im SSIS-Designer verwendet wird, oder wenn es vom Code aufgerufen wird. Für weitere Informationen zum Schreiben der Validate Methode für eine benutzerdefinierte Aufgabe siehe Coding a Custom Task.