PipelineComponent.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.
Importante
Questa API non è conforme a CLS.
Verifica che il componente sia configurato correttamente.
public:
virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Overridable Function Validate () As DTSValidationStatusRestituisce
Valore dell'enumerazione DTSValidationStatus che indica lo stato del componente.
- Attributi
Commenti
Il Validate metodo viene sottoposto a override 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 ComponentMetaData durante Validate.
L'implementazione della classe base di Validate verifica l'esistenza di IDTSInputColumn100 oggetti la cui LineageID proprietà non corrisponde a LineageID di un IDTSOutputColumn100 di un componente a monte. Gli sviluppatori di componenti devono estendere la funzionalità della classe Validate di base eseguendo controlli aggiuntivi su ComponentMetaData. 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.
Se il componente usa una connessione, deve 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 a FireError e FireWarning vengono visualizzate nella finestra Elenco errori in SQL Server Data Tools (SSDT) e devono fornire agli utenti indicazioni 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 in modo errato, ma le modifiche apportate dall'utente a ComponentMetaData risolveranno i problemi. |
| VS_NEEDSNEWMETADATA | Indica che gli errori di convalida possono essere corretti dal componente nell'implementazione del ReinitializeMetaData metodo . SSIS Designer chiederà agli utenti che il componente può ripristinarsi quando VS_NEEDSNEWMETADATAe successivamente ReinitializeMetaData viene chiamato . |
| VS_ISCORRUPT | Indica che l'oggetto ComponentMetaData è danneggiato e non può essere ripristinato da una chiamata a ReinitializeMetaData o da modifiche al componente. |
Quando la DelayValidation proprietà dell'attività flusso di dati è true, le chiamate in fase di progettazione a Validate vengono eliminate e il metodo viene chiamato prima dell'esecuzione del componente.
Per altre informazioni, vedere Convalida di un componente del flusso di dati.