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::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.DTSValidationStatusPublic Function Validate () As DTSValidationStatusValori restituiti
Un valore dall'enumerazione DTSValidationStatus che indica lo stato del componente.
- Attributi
Commenti
Il metodo Validate è implementato dagli sviluppatori dei 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 dovrebbero modificare il suo IDTSComponentMetaData100 durante la Validazione.
Ogni componente ha requisiti diversi per una validazione di successo, ma il seguente elenco fornisce alcuni degli elementi comuni che dovrebbero essere validati.
Verifica che il componente abbia il numero atteso di oggetti IDTSInput100 e IDTSOutput100.
Verifica che eventuali oggetti IDTSCustomProperty100 continuino a esistere e contengano i valori corretti.
Verifica che ogni oggetto IDTSInputColumn100 nella sua IDTSInputColumnCollection100 faccia riferimento a un oggetto IDTSOutputColumn100 esistente in un componente a monte.
Se il componente utilizza una connessione, verifica che IDTSRuntimeConnection100 sia specificato e che il ConnectionManager sia presente nel pacchetto.
I componenti dovrebbero fornire feedback agli utenti quando la validazione fallisce. Il feedback è fornito tramite i metodi FireError e FireWarning e dal valore di ritorno DTSValidationStatus. Le chiamate ai metodi FireError e FireWarning sono visualizzate nella finestra della Lista Attività in SQL Server Data Tools (SSDT) e dovrebbero fornire indicazioni agli utenti sul fallimento della validazione. Dei quattro valori nell'enumerazione DTSValidationStatus, solo VS_ISVALID indica una validazione riuscita. Gli altri tre valori indicano diversi livelli di cedenza. La tabella seguente descrive i valori di guasto nell'enumerazione e come vengono interpretati dal progettista SSIS.
| Condizione | Descrizione |
|---|---|
| VS_ISBROKEN | Indica che il componente non è configurato correttamente. L'utente deve apportare modifiche ai ComponentMetaData per risolvere i problemi. |
| VS_NEEDSNEWMETADATA | Indica che gli errori di validazione possono essere corretti dal componente nella sua implementazione del metodo ReinitializeMetaData. Il progettista SSIS avviserà gli utenti che il componente può ripararsi da solo quando il valore di enumerazione è VS_NEEDSNEWMETADATA. Poi il progettista richiamerà il metodo ReinitializeMetaData. |
| VS_ISCORRUPT | Indica che il ComponentMetaData è corrotto e non può essere riparato tramite una chiamata al metodo ReinitializeMetaData o tramite modifiche al componente. |
Quando la proprietà DelayValidation del compito di flusso dati è vera, le chiamate a tempo di progettazione al metodo Validate vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.