ForEachEnumerator.Validate(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging) Metodo

Definizione

Consente al contenitore di determinare se contiene impostazioni non valide che ne impediranno l'esecuzione corretta.

public:
 virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overridable Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult

Parametri

connections
Connections

Raccolta Connections per l'oggetto ForEachEnumerator.

variableDispenser
VariableDispenser

Raccolta Variables per il contenitore.

infoEvents
IDTSInfoEvents

Oggetto che implementa l'interfaccia IDTSInfoEvents per la generazione di eventi quali, ad esempio, errori e avvisi durante la persistenza.

log
IDTSLogging

Interfaccia di IDTSLogging.

Restituisce

DTSExecResult

Valore dell'enumerazione DTSExecResult che indica l'esito positivo o negativo della convalida.

Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrato come convalidare gli oggetti utilizzando il Validate metodo dell' Package oggetto.

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);  
Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)  

Commenti

Il Validate metodo esamina le proprietà e le impostazioni per le imprecisioni o le impostazioni non corrette. Il metodo non tocca i dati oppure si connette alle origini dati per convalidare le connessioni. Tuttavia, garantisce che i campi obbligatori vengano popolati e contengano valori appropriati. I campi convalidati variano a seconda dell'oggetto da convalidare.

L'utilizzo principale di Validate è quando si scrive un'attività personalizzata. Il Validate metodo viene chiamato da Progettazione SSIS quando un'attività viene rilasciata nell'area di progettazione e nuovamente, potenzialmente più volte, durante l'impostazione delle proprietà. Tuttavia, nel codice, il Validate metodo sui singoli oggetti non viene comunemente utilizzato, in quanto è consigliabile chiamare il Validate metodo su Package quando è necessario convalidare gli oggetti. Tuttavia, il metodo è disponibile nei singoli oggetti se è necessario trovare una circostanza univoca in cui è necessario.

Il Validate metodo viene sottoposto a override nelle attività personalizzate, per la convalida dell'oggetto quando viene utilizzato in Progettazione SSIS o quando viene chiamato dal codice. Per altre informazioni sulla scrittura del Validate metodo per un'attività personalizzata, vedere codifica di un'attività personalizzata.

Si applica a