Freigeben über


ForEachEnumerator.Validate Methode

Definition

Der Container kann feststellen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern.

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 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);
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.DTSExecResult
Public Overridable Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult

Parameter

connections
Connections

Die Connections-Auflistung für ForEachEnumerator.

variableDispenser
VariableDispenser

Die Variables-Auflistung für den Container.

infoEvents
IDTSInfoEvents

Ein Objekt, das die IDTSInfoEvents-Schnittstelle zum Auslösen von Ereignissen (Fehlern, Warnungen usw.) während der Persistenz implementiert.

log
IDTSLogging

Eine IDTSLogging-Schnittstelle.

Gibt zurück

Ein Wert aus der DTSExecResult-Enumeration, der die erfolgreiche Überprüfung oder einen Fehler angibt.

Implementiert

Beispiele

Das folgende Codebeispiel zeigt, wie Objekte mithilfe der Validate 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. Es stellt jedoch sicher, dass erforderliche Felder aufgefüllt und entsprechende Werte enthalten. Die felder, die überprüft werden, unterscheiden sich je nachdem, welches Objekt überprüft wird.

Die primäre Verwendung erfolgt Validate beim Schreiben einer benutzerdefinierten Aufgabe. Die Validate Methode wird vom SSIS-Designer aufgerufen, wenn eine Aufgabe auf der Entwurfsoberfläche abgelegt wird 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 empfohlen wird, die Validate Methode für die Package Überprüfung von 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 Aufgaben überschrieben, entweder zur Überprüfung des Objekts, wenn sie im SSIS-Designer verwendet wird, oder wenn sie vom Code aufgerufen wird. Weitere Informationen zum Schreiben der Validate Methode für einen benutzerdefinierten Vorgang finden Sie unter Codieren einer benutzerdefinierten Aufgabe.

Gilt für: