Freigeben über

IDTSDesigntimeComponent100.Validate Methode

  • Referenz

Definition

Namespace:
Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012
Assembly:
Microsoft.SqlServer.DTSPipelineWrap.dll
public:
 Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2012::DTSValidationStatus Validate();
[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate ();
[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus
Public Function Validate () As DTSValidationStatus

Gibt zurück

DTSValidationStatus

Ein Wert aus der DTSValidationStatus-Enumeration, der den Status der Komponente angibt.

Attribute
DispIdAttribute

Hinweise

Die Validate-Methode wird von Komponentenentwicklern implementiert, um zu überprüfen, ob die Komponente ordnungsgemäß konfiguriert ist. Sie wird während des Paketentwurfs wiederholt und einmal vor der Ausführung der Komponente aufgerufen. Komponenten sollten ihre IDTSComponentMetaData100 während der Überprüfung nicht ä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.

  • Stellen Sie sicher, dass die Komponente über die erwartete Anzahl von IDTSInput100- und IDTSOutput100-Objekten verfügt.

  • Stellen Sie sicher, dass alle IDTSCustomProperty100-Objekte weiterhin vorhanden sind und die richtigen Werte enthalten.

  • Stellen Sie sicher, 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 IDTSRuntimeConnection100 angegeben ist und dass connectionManager im Paket vorhanden ist.

Komponenten sollten Benutzern Feedback geben, wenn die Überprüfung fehlschlägt. Feedback wird über die FireError- und FireWarning-Methoden und den DTSValidationStatus-Rückgabewert bereitgestellt. Aufrufe der Methoden FireError und FireWarning werden im Fenster Aufgabenliste in SQL Server Data Tools (SSDT) angezeigt und sollten Benutzern Anleitungen zum Überprüfungsfehler bieten. Von den vier Werten in der DTSValidationStatus-Enumeration gibt nur VS_ISVALID eine erfolgreiche Validierung 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 ComponentMetaData vornehmen, um die Probleme zu beheben.
VS_NEEDSNEWMETADATA Gibt an, dass die Validierungsfehler von der Komponente in ihrer Implementierung der ReinitializeMetaData-Methode behoben werden können. Der SSIS-Designer fordert Benutzer auf, dass die Komponente sich selbst reparieren kann, wenn der Enumerationswert VS_NEEDSNEWMETADATA ist. Anschließend ruft der Designer die ReinitializeMetaData-Methode auf.
VS_ISCORRUPT Gibt an, dass componentMetaData beschädigt ist und nicht durch einen Aufruf der ReinitializeMetaData-Methode oder durch Bearbeitungen an der Komponente repariert werden kann.

Wenn die DelayValidation-Eigenschaft des Datenflusstasks true ist, werden Entwurfszeitaufrufe der Validate-Methode eliminiert, und die Methode wird stattdessen vor der Komponentenausführung aufgerufen.

Gilt für: