IDTSDesigntimeComponent100.Validate Metodo

Definizione

Spazio dei nomi:

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

Restituisce

DTSValidationStatus

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

Attributi

DispIdAttribute

Commenti

Il metodo Validate viene implementato 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 modificare il relativo IDTSComponentMetaData100 durante la convalida.

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 oggetti IDTSInput100 e IDTSOutput100.

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

• Verificare che ogni oggetto IDTSInputColumn100 nel relativo IDTSInputColumnCollection100 faccia riferimento a un oggetto IDTSOutputColumn100 esistente in un componente upstream.

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

I componenti devono fornire feedback agli utenti quando la convalida ha esito negativo. Il feedback viene fornito tramite i metodi FireError e FireWarning e dal valore restituito DTSValidationStatus. Le chiamate ai metodi FireError e FireWarning vengono visualizzate nella finestra Elenco attività in SQL Server Data Tools (SSDT) e devono fornire indicazioni agli utenti sull'errore di convalida. Dei quattro valori nell'enumerazione DTSValidationStatus, solo VS_ISVALID indica che 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 correttamente. L'utente deve apportare modifiche a ComponentMetaData per risolvere i problemi.
VS_NEEDSNEWMETADATA	Indica che gli errori di convalida possono essere corretti dal componente nell'implementazione del metodo ReinitializeMetaData. La finestra di progettazione SSIS chiederà agli utenti che il componente può ripristinarsi quando il valore di enumerazione è VS_NEEDSNEWMETADATA. La finestra di progettazione chiamerà quindi il metodo ReinitializeMetaData.
VS_ISCORRUPT	Indica che ComponentMetaData è danneggiato e non può essere ripristinato da una chiamata al metodo ReinitializeMetaData o dalle modifiche apportate al componente.

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