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.
Überprüft, ob die Komponente ordnungsgemäß konfiguriert ist.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatusGibt zurück
Ein Wert aus der DTSValidationStatus-Enumeration, der den Status der Komponente angibt.
- Attribute
Hinweise
Die Validate -Methode wird von Komponentenentwicklern implementiert, um zu überprüfen, ob die Komponente ordnungsgemäß konfiguriert ist. Es wird wiederholt während des Paketentwurfs und ein Mal vor der Ausführung der Komponente aufgerufen. Komponenten sollten ihre IDTSComponentMetaData100 während Validatenicht ändern.
Jede Komponente hat unterschiedliche Anforderungen für eine erfolgreiche Validierung, aber die folgende Liste enthält einige der allgemeinen Elemente, die überprüft werden sollten.
Vergewissern Sie sich, dass die Komponente die erwartete Anzahl von IDTSInput100 Objekten und IDTSOutput100 aufweist.
Vergewissern Sie sich, dass alle IDTSCustomProperty100 Objekte weiterhin vorhanden sind und die richtigen Werte enthalten.
Vergewissern Sie sich, dass jedes IDTSInputColumn100 Objekt in seiner IDTSInputColumnCollection100 auf ein vorhandenes IDTSOutputColumn100 Objekt in einer Upstreamkomponente verweist.
Wenn die Komponente eine Verbindung verwendet, überprüfen Sie, ob angegeben IDTSRuntimeConnection100 ist und dass die ConnectionManager im Paket vorhanden ist.
Komponenten sollten Benutzern Feedback geben, wenn die Überprüfung fehlschlägt. Feedback wird über die FireError Methoden und FireWarning und durch den DTSValidationStatus Rückgabewert bereitgestellt. Aufrufe der FireError Methoden und FireWarning werden im Fenster Aufgabenliste in SQL Server Data Tools (SSDT) angezeigt und sollten Benutzern Anleitungen zum Validierungsfehler bieten. Von den vier Werten in der Enumeration gibt nur VS_ISVALID eine DTSValidationStatus erfolgreiche Überprüfung an. Die anderen drei Werte weisen auf unterschiedliche Fehlerebenen hin. In der folgenden Tabelle werden die Fehlerwerte in der Enumeration und ihre Interpretation durch den SSIS-Designer beschrieben.
| Status | BESCHREIBUNG |
|---|---|
| VS_ISBROKEN | Gibt an, dass die Komponente nicht ordnungsgemäß konfiguriert ist. Der Benutzer muss Änderungen an der ComponentMetaData vornehmen, 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 Benutzer auf, dass die Komponente sich selbst reparieren kann, wenn der Enumerationswert ist VS_NEEDSNEWMETADATA. Anschließend ruft der Designer die -Methode auf ReinitializeMetaData . |
| VS_ISCORRUPT | Gibt an, dass die ComponentMetaData beschädigt ist und nicht durch einen Aufruf der ReinitializeMetaData -Methode oder durch Bearbeitungen der Komponente repariert werden kann. |
Wenn die DelayValidation Eigenschaft des Datenflusstasks ist true, werden Entwurfszeitaufrufe der Validate -Methode eliminiert, und die Methode wird stattdessen vor der Komponentenausführung aufgerufen.