IDTSDesigntimeComponent100.Validate Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Verifica che il componente sia configurato correttamente.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRestituisce
Valore dell'enumerazione DTSValidationStatus che indica lo stato del componente.
- Attributi
Commenti
Il Validate metodo 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 modificarne IDTSComponentMetaData100 durante Validate.
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.
Verificare che ogni IDTSInputColumn100 oggetto nel relativo IDTSInputColumnCollection100 faccia riferimento a un oggetto esistente IDTSOutputColumn100 in un componente upstream.
Se il componente usa una connessione, 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 ai FireError metodi 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 , 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 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 ReinitializeMetaData metodo . 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 ReinitializeMetaData metodo . |
| VS_ISCORRUPT | Indica che l'oggetto ComponentMetaData è danneggiato e non può essere ripristinato da una chiamata al ReinitializeMetaData metodo o dalle modifiche apportate al componente. |
Quando la DelayValidation proprietà dell'attività flusso di dati è true, le chiamate in fase di progettazione al Validate metodo vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.