PipelineComponent.Validate Methode

Definition

Namespace:: Microsoft.SqlServer.Dts.Pipeline

Assembly:: Microsoft.SqlServer.PipelineHost.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.

Wichtig

Diese API ist nicht CLS-kompatibel.

Überprüft, dass die Komponente korrekt 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 Aufzählung, der den Status der Komponente angibt.

Attribute: CLSCompliantAttribute

Hinweise

Die Methode Validate wird von Komponentenentwicklern überschrieben, 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 seine ComponentMetaData während Validatenicht verändern.

Die Basisklassenimplementierung von Validate prüft die Existenz von IDTSInputColumn100 Objekten, deren LineageID Eigenschaft nicht mit der LineageID von an IDTSOutputColumn100 einer vorgelagerten Komponente übereinstimmt. Komponentenentwickler sollten die Funktionalität der Basisklasse Validate erweitern, indem sie zusätzliche Überprüfungen auf dem durchführen.ComponentMetaData 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.
Wenn die Komponente eine Verbindung verwendet, sollte sie überprüfen, 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 FireError und FireWarning werden im Fehlerlistenfenster in SQL Server Data Tools (SSDT) angezeigt und sollten den Nutzern Hinweise zum Validierungsfehler geben. Von den vier Werten in der Aufzählung DTSValidationStatus bedeutet nur VS_ISVALID eine erfolgreiche Validierung. 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	Zeigt an, dass die Komponente nicht falsch konfiguriert ist, aber Änderungen des Benutzers ComponentMetaData lösen die Probleme.
VS_NEEDSNEWMETADATA	Gibt an, dass die Validierungsfehler von der Komponente bei der Implementierung der ReinitializeMetaData Methode behoben werden können. SSIS Designer fordert die Benutzer darauf auf, dass die Komponente sich selbst reparieren kann, wenn VS_NEEDSNEWMETADATA, und anschließend ReinitializeMetaData aufgerufen wird.
VS_ISCORRUPT	Zeigt an, dass die beschädigt ComponentMetaData ist und nicht durch einen Aufruf oder ReinitializeMetaData durch Bearbeitungen der Komponente repariert werden kann.

Wenn die DelayValidation Eigenschaft der Datenflussaufgabe ist true, werden die Designzeitaufrufe Validate eliminiert und die Methode vor der Ausführung der Komponente aufgerufen.

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

Gilt für: