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.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRestituisce
Valore dell'enumerazione DTSValidationStatus che indica lo stato del componente.
- Attributi
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 modificarne 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 IDTSInput100 oggetti e IDTSOutput100 .
Verificare che tutti gli IDTSCustomProperty100 oggetti continuino a esistere e contengano i valori corretti.
Verificare che ogni oggetto IDTSInputColumn100 faccia IDTSInputColumnCollection100 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 , 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 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 metodo Validate vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.