IDTSDesigntimeComponent100.Validate Methode

Definition

Namespace:: Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012

Assembly:: Microsoft.SqlServer.DTSPipelineWrap.dll

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::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-Aufzählung, der den Status der Komponente angibt.

Attribute: DispIdAttribute

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 ihre IDTSComponentMetaData100 während der Validierung 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 an IDTSInput100- und IDTSOutput100-Objekten besitzt.
Überprüfen Sie, dass alle IDTSCustomProperty100-Objekte weiterhin existieren und die korrekten Werte enthalten.
Überprüfen Sie, dass jedes IDTSInputColumn100-Objekt in seinem IDTSInputColumnCollection100 in einer Upstream-Komponente auf ein bestehendes IDTSOutputColumn100-Objekt verweisen kann.
Wenn die Komponente eine Verbindung verwendet, überprüfen Sie, ob die IDTSRuntimeConnection100 angegeben ist und dass der ConnectionManager im Paket existiert.

Komponenten sollten den Nutzern Feedback geben, wenn die Validierung fehlschlägt. Rückmeldung erfolgt über die Methoden FireError und FireWarning sowie über den DTSValidationStatus-Rückgabewert. Aufrufe der FireError- und FireWarning-Methoden werden im Task List-Fenster in SQL Server Data Tools (SSDT) angezeigt und sollten den Nutzern Hinweise zum Validierungsfehler geben. Von den vier Werten in der DTSValidationStatus-Aufzählung zeigt nur VS_ISVALID eine erfolgreiche Validierung an. 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 an der ComponentMetaData vornehmen, um die Probleme zu beheben.
VS_NEEDSNEWMETADATA	Zeigt an, dass die Validierungsfehler von der Komponente in ihrer 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 ReinitializeMetaData-Methode auf.
VS_ISCORRUPT	Gibt an, dass die ComponentMetaData beschädigt ist und nicht durch einen Aufruf der ReinitializeMetaData-Methode oder durch Änderungen an der Komponente repariert werden kann.

Wenn die DelayValidify-Eigenschaft der Datenflussaufgabe wahr ist, werden Design-Time-Aufrufe der Validate-Methode eliminiert und die Methode wird stattdessen vor der Ausführung der Komponenten aufgerufen.

Gilt für: