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 DTSValidationStatusValori restituiti
Un valore dall'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 correttamente configurato. 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 Validate.
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 IDTSInput100 oggetti e IDTSOutput100 .
Verifica che eventuali IDTSCustomProperty100 oggetti continuino a esistere e contengano i valori corretti.
Verifica che ogni IDTSInputColumn100 oggetto nel suo IDTSInputColumnCollection100 riferimenti a un oggetto esistente IDTSOutputColumn100 in un componente a monte.
Se il componente utilizza una connessione, verifica che il IDTSRuntimeConnection100 sia specificato e che il ConnectionManager esista nel package.
I componenti dovrebbero fornire feedback agli utenti quando la validazione fallisce. Il feedback è fornito attraverso i FireError metodi e FireWarning tramite il DTSValidationStatus valore di ritorno. Le chiamate ai FireError metodi 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 , indica solo VS_ISVALID 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 al ComponentMetaData per risolvere i problemi. |
| VS_NEEDSNEWMETADATA | Indica che gli errori di validazione possono essere corretti dal componente nella sua implementazione del ReinitializeMetaData metodo. 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 ReinitializeMetaData metodo. |
| VS_ISCORRUPT | Indica che il ComponentMetaData metodo è corrotto e non può essere riparato tramite una chiamata al ReinitializeMetaData metodo o modifiche al componente. |
Quando la DelayValidation proprietà del compito di flusso dati è true, le chiamate in tempo di progettazione al Validate metodo vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.