IDTSDesigntimeComponent100.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.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatus Validate();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatusPublic Function Validate () As DTSValidationStatusGibt zurück
Ein Wert aus der DTSValidationStatus Aufzählung, der den Status der Komponente angibt.
- Attribute
Hinweise
Die Validate-Methode wird von Komponentenentwicklern implementiert, um zu überprüfen, dass die Komponente korrekt konfiguriert ist. Sie wird während des Paketdesigns wiederholt aufgerufen und einmal vor der Ausführung der Komponente. Komponenten sollten es IDTSComponentMetaData100 während der Validate nicht ändern.
Jede Komponente hat unterschiedliche Anforderungen für eine erfolgreiche Validierung, aber die folgende Liste enthält einige der häufigsten Punkte, die validiert werden sollten.
Überprüfen Sie, dass die Komponente die erwartete Anzahl von IDTSInput100 und IDTSOutput100 Objekten hat.
Überprüfen Sie, dass alle IDTSCustomProperty100 Objekte weiterhin existieren und die korrekten Werte enthalten.
Überprüfen Sie, dass jedes IDTSInputColumn100-Objekt in seinem IDTSInputColumnCollection100 Objekt auf ein bestehendes IDTSOutputColumn100 Objekt in einer Upstream-Komponente verweist.
Wenn die Komponente eine Verbindung verwendet, überprüfen Sie, dass die IDTSRuntimeConnection100 angegeben ist und dass die im ConnectionManager Paket existiert.
Komponenten sollten den Nutzern Feedback geben, wenn die Validierung fehlschlägt. Rückkopplung erfolgt über die FireError und-Methoden FireWarning und durch den DTSValidationStatus Rückgabewert. Aufrufe zu den FireError und-Methoden FireWarning werden im Aufgabenlistenfenster in SQL Server Data Tools (SSDT) angezeigt und sollten den Nutzern Hinweise zum Validierungsfehler geben. Von den vier Werten in der DTSValidationStatus Aufzählung deutet nur VS_ISVALID auf eine erfolgreiche Validierung hin. Die anderen drei Werte zeigen unterschiedliche Ausfallgrade an. Die folgende Tabelle beschreibt die Fehlerwerte in der Aufzählung und wie sie vom SSIS-Designer interpretiert werden.
| Status | BESCHREIBUNG |
|---|---|
| VS_ISBROKEN | Das zeigt an, dass die Komponente nicht korrekt konfiguriert ist. Der Benutzer muss Änderungen vornehmen ComponentMetaData , um die Probleme zu beheben. |
| VS_NEEDSNEWMETADATA | Gibt an, dass die Validierungsfehler von der Komponente bei der Implementierung der ReinitializeMetaData Methode behoben werden können. Der SSIS-Designer fordert die Benutzer darauf auf, dass sich die Komponente selbst reparieren kann, wenn der Aufzählungswert VS_NEEDSNEWMETADATA. Dann ruft der Designer die Methode ReinitializeMetaData auf. |
| VS_ISCORRUPT | Zeigt an, dass das beschädigt ComponentMetaData ist und nicht durch einen Aufruf der Methode ReinitializeMetaData oder durch Bearbeitungen der Komponente repariert werden kann. |
Wenn die DelayValidation Eigenschaft der Datenflussaufgabe wahr ist, werden Designzeitaufrufe der Validate-Methode eliminiert und die Methode wird stattdessen vor der Ausführung der Komponenten aufgerufen.