ForEachEnumerator.Validate(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging) 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.
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
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.