DtsContainer.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.
Ermöglicht es dem Container zu bestimmen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern.
public:
override 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 override 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);override this.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 Overrides Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResultParameter
- connections
- Connections
Die Sammlung Connections für den Behälter.
- events
- IDTSEvents
Eine Schnittstelle IDTSEvents , um Ereignisse anzusprechen.
- log
- IDTSLogging
Eine IDTSLogging-Schnittstelle.
Gibt zurück
Eine DTSExecResult Aufzählung, die das Ergebnis der Validierung 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.