ForEachEnumeratorHost.Validate 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.
Ermöglicht es dem Host zu bestimmen, ob es ungültige Einstellungen gibt, die verhindern, dass die Ausführung erfolgreich ForEachEnumerator ausgeführt wird.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResultParameter
- connections
- Connections
Eine Sammlung von Verbindungen, die von der verwendet werden ForEachEnumerator.
- variableDispenser
- VariableDispenser
Ein Objekt zum Sperren VariableDispenser von Variablen.
- infoEvents
- IDTSInfoEvents
Ein Objekt, das die IDTSInfoEvents Schnittstelle implementiert.
- log
- IDTSLogging
Ein Objekt, das die IDTSLogging Schnittstelle implementiert.
Gibt zurück
Eine DTSExecResult Aufzählung, die das Ergebnis der Validierung anzeigt.
Implementiert
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.