PipelineComponent.Validate Metodo

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dts.Pipeline

Assembly:: Microsoft.SqlServer.PipelineHost.dll

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.DTSValidationStatus

Public Overridable Function Validate () As DTSValidationStatus

Valori restituiti

DTSValidationStatus

Un valore dall'enumerazione DTSValidationStatus che indica lo stato del componente.

Attributi: CLSCompliantAttribute

Commenti

Il Validate metodo viene sovrascritto 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 dovrebbero modificare il suo ComponentMetaData durante Validate.

L'implementazione della classe base controlla Validate l'esistenza di IDTSInputColumn100 oggetti la cui LineageID proprietà non corrisponde a quella LineageID di un IDTSOutputColumn100 componente a monte. Gli sviluppatori di componenti dovrebbero estendere la funzionalità della classe Validate base effettuando ulteriori controlli sul ComponentMetaDatafile . 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.
Se il componente utilizza una connessione, dovrebbe verificare 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 a FireError e FireWarning sono visualizzate nella finestra Elenco Errori 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 in modo errato, ma le modifiche dell'utente ComponentMetaData risolveranno i problemi.
VS_NEEDSNEWMETADATA	Indica che gli errori di validazione possono essere corretti dal componente nella sua implementazione del ReinitializeMetaData metodo. SSIS Designer avviserà gli utenti che il componente può ripararsi da solo quando VS_NEEDSNEWMETADATA, e successivamente ReinitializeMetaData viene chiamato.
VS_ISCORRUPT	Indica che il ComponentMetaData componente è corrotto e non può essere riparato tramite una chiamata o ReinitializeMetaData modifiche al componente.

Quando la DelayValidation proprietà del compito di flusso dati è true, le chiamate al tempo 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.

Si applica a