LogProviderBase.Validate(IDTSInfoEvents) 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.
Wird aufgerufen, um die ordnungsgemäße Konfiguration des Protokollanbieters zu bestätigen.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultParameter
- events
- IDTSInfoEvents
Eine IDTSInfoEvents-Schnittstelle, die verwendet wird, um Informationsereignisse während der Paketausführung auszulösen.
Gibt zurück
Ein Wert aus der DTSExecResult-Struktur, der eine erfolgreiche Überprüfung oder einen Fehler angibt.
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. Bei Protokollanbietern überprüft die Validate Methode, dass die ConfigString Eigenschaft ordnungsgemäß konfiguriert ist, und alle anderen Eigenschaften oder Einstellungen, die für den Protokollanbieter erforderlich sind, werden wie erwartet festgelegt. Protokollanbieter, die Verbindungen mit externen Datenquellen erfordern, führen dies über die Verwendung von ConnectionManager Objekten aus. Die ConfigString Eigenschaft wird häufig verwendet, um den Namen oder die ID einer ConnectionManager in der Connections Auflistung enthalten.
In diesem Fall sollte überprüft werden, Validate ob die ConnectionManager in der ConfigString Eigenschaft angegebene Eigenschaft im Paket vorhanden ist.
Wenn Failure zurückgegeben wird, wird die Paketausführung abgebrochen.
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.