PipelineComponent.Validate Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Pipeline

Assembly:

Microsoft.SqlServer.PipelineHost.dll

Importante

Questa API non è conforme a CLS.

Verifica che il componente sia configurato correttamente.

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

Restituisce

DTSValidationStatus

Valore dell'enumerazione DTSValidationStatus che indica lo stato del componente.

Attributi

CLSCompliantAttribute

Commenti

Il Validate metodo viene sottoposto a override dagli sviluppatori di componenti per verificare che il componente sia configurato correttamente. Viene chiamato ripetutamente durante la progettazione del pacchetto e una volta prima dell'esecuzione del componente. I componenti non devono modificarne ComponentMetaData durante Validate.

L'implementazione della classe base di Validate verifica l'esistenza di IDTSInputColumn100 oggetti la cui LineageID proprietà non corrisponde a LineageID di un IDTSOutputColumn100 di un componente a monte. Gli sviluppatori di componenti devono estendere la funzionalità della classe Validate di base eseguendo controlli aggiuntivi su ComponentMetaData. Ogni componente ha requisiti diversi per la corretta convalida, ma l'elenco seguente fornisce alcuni degli elementi comuni che devono essere convalidati.

• Verificare che il componente abbia il numero previsto di IDTSInput100 oggetti e IDTSOutput100 .

• Verificare che tutti gli IDTSCustomProperty100 oggetti continuino a esistere e contengano i valori corretti.

• Se il componente usa una connessione, deve verificare che sia IDTSRuntimeConnection100 specificato e che esista ConnectionManager nel pacchetto.

I componenti devono fornire feedback agli utenti quando la convalida ha esito negativo. Il feedback viene fornito tramite i FireError metodi e FireWarning e dal valore restituito DTSValidationStatus . Le chiamate a FireError e FireWarning vengono visualizzate nella finestra Elenco errori in SQL Server Data Tools (SSDT) e devono fornire agli utenti indicazioni sull'errore di convalida. Dei quattro valori nell'enumerazione DTSValidationStatus , indica solo VS_ISVALID la convalida riuscita. Gli altri tre valori indicano livelli diversi di errore. Nella tabella seguente vengono descritti i valori di errore nell'enumerazione e il modo in cui vengono interpretati dal Designer SSIS.

Stato	Descrizione
VS_ISBROKEN	Indica che il componente non è configurato in modo errato, ma le modifiche apportate dall'utente a ComponentMetaData risolveranno i problemi.
VS_NEEDSNEWMETADATA	Indica che gli errori di convalida possono essere corretti dal componente nell'implementazione del ReinitializeMetaData metodo . SSIS Designer chiederà agli utenti che il componente può ripristinarsi quando VS_NEEDSNEWMETADATAe successivamente ReinitializeMetaData viene chiamato .
VS_ISCORRUPT	Indica che l'oggetto ComponentMetaData è danneggiato e non può essere ripristinato da una chiamata a ReinitializeMetaData o da modifiche al componente.

Quando la DelayValidation proprietà dell'attività flusso di dati è true, le chiamate in fase di progettazione a Validate vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.

Per altre informazioni, vedere Convalida di un componente del flusso di dati.