PipelineComponent.Validate Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Pipeline

Assembly:

Microsoft.SqlServer.PipelineHost.dll

Wichtig

Diese API ist nicht CLS-kompatibel.

Überprüft, ob die Komponente ordnungsgemäß konfiguriert ist.

public:
 virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();

[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();

[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus

Public Overridable Function Validate () As DTSValidationStatus

Gibt zurück

DTSValidationStatus

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

Attribute

CLSCompliantAttribute

Hinweise

Die Validate Methode wird von Komponentenentwicklern außer Kraft gesetzt, um zu überprüfen, ob die Komponente ordnungsgemäß konfiguriert ist. Sie wird während des Paketentwurfs wiederholt aufgerufen, und einmal vor der Ausführung der Komponente. Komponenten sollten die ComponentMetaData Komponenten während der Zeit Validatenicht ändern.

Die Basisklassenimplementierung von Validate Prüfungen für das Vorhandensein von IDTSInputColumn100 Objekten, deren LineageID Eigenschaft nicht mit LineageID einer IDTSOutputColumn100 vorgelagerten Komponente übereinstimmt. Komponentenentwickler sollten die Basisklassenfunktionalität Validate erweitern, indem sie zusätzliche Überprüfungen auf die ComponentMetaData. Jede Komponente verfügt über unterschiedliche Anforderungen für die erfolgreiche Überprüfung, die folgende Liste enthält jedoch einige der allgemeinen Elemente, die überprüft werden sollten.

• Stellen Sie sicher, dass die Komponente über die erwartete Anzahl und IDTSInput100IDTSOutput100 Objekte verfügt.

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

• Wenn die Komponente eine Verbindung verwendet, sollte überprüft werden, ob die IDTSRuntimeConnection100 angabe ist und dass das ConnectionManager Paket vorhanden ist.

Komponenten sollten Benutzern Feedback geben, wenn die Überprüfung fehlschlägt. Feedback wird über die FireError Und-Methoden FireWarning und den DTSValidationStatus Rückgabewert bereitgestellt. Aufrufe und FireErrorFireWarning Werden im Fenster "Fehlerliste" in SQL Server Data Tools (SSDT) angezeigt und sollten Benutzern Anleitungen zum Überprüfungsfehler geben. Der vier Werte in der DTSValidationStatus Aufzählung gibt nur VS_ISVALID eine erfolgreiche Überprüfung an. Die anderen drei Werte deuten auf unterschiedliche Fehlerebenen hin. In der folgenden Tabelle werden die Fehlerwerte in der Enumeration und die Interpretation durch den SSIS-Designer beschrieben.

Status	Beschreibung
VS_ISBROKEN	Gibt an, dass die Komponente nicht falsch konfiguriert ist, aber vom Benutzer geändert wird, um ComponentMetaData die Probleme zu beheben.
VS_NEEDSNEWMETADATA	Gibt an, dass die Überprüfungsfehler durch die Komponente in der Implementierung der ReinitializeMetaData Methode behoben werden können. Der SSIS-Designer fordert Benutzer auf, dass die Komponente sich selbst reparieren kann, wenn VS_NEEDSNEWMETADATAund anschließend ReinitializeMetaData aufgerufen wird.
VS_ISCORRUPT	Gibt an, dass die ComponentMetaData Beschädigte ist und nicht durch einen Aufruf ReinitializeMetaData oder durch Bearbeitungen der Komponente repariert werden kann.

Wenn die DelayValidation Eigenschaft der Datenflussaufgabe lautet true, werden die Entwurfszeitaufrufe Validate beseitigt, und die Methode wird vor der Komponentenausführung aufgerufen.

Weitere Informationen zu finden Sie unter Überprüfen einer Datenflusskomponente.