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