Linguaggio

ForEachEnumerator.Validate Metodo

Definizione

Permette al contenitore di determinare se contiene impostazioni non valide che impediranno l'esecuzione con successo.

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

La Variables raccolta per il container.

infoEvents
IDTSInfoEvents

Un oggetto che implementa l'interfaccia IDTSInfoEvents per l'esecuzione di eventi di sparo (errori, avvisi e così via) durante la persistenza.

log
IDTSLogging

Interfaccia IDTSLogging.

Valori restituiti

Un valore dell'enumerazione DTSExecResult che indica il successo o il fallimento della validazione.

Implementazioni

Esempio

Il seguente esempio di codice mostra come validare oggetti usando il Validate metodo dell'oggetto Package .

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

Commenti

Il Validate metodo controlla proprietà e impostazioni per individuare imprecisioni o impostazioni errate. Il metodo non tocca i dati né si collega alle fonti dati per validare le connessioni. Tuttavia, garantisce che i campi richiesti siano popolati e contengano valori appropriati. I campi validati differiscono a seconda dell'oggetto che viene convalidato.

L'uso principale Validate è quando scrivo un compito personalizzato. Il Validate metodo viene chiamato dal SSIS Designer quando un compito viene inserito sulla superficie di progettazione e, potenzialmente, più volte quando le proprietà vengono impostate. Tuttavia, nel codice, il Validate metodo su singoli oggetti non è comunemente usato, poiché si consiglia di chiamare il Validate metodo su quando Package è necessario validare gli oggetti. Tuttavia, il metodo è disponibile per singoli oggetti nel caso si trovi una circostanza unica in cui sia necessario.

Il Validate metodo viene sovrascritto nei compiti personalizzati, sia per la validazione dell'oggetto quando usato nel SSIS Designer, sia quando chiamato dal codice. Per maggiori informazioni sulla scrittura del Validate metodo per un compito personalizzato, vedi Coding a Custom Task.

Si applica a