ForEachEnumeratorHost.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.
Consente all'host di determinare se esistono impostazioni non valide che impediranno l'esecuzione corretta di ForEachEnumerator.
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 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 Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult
Parametri
- connections
- Connections
Raccolta di connessioni utilizzate dall'oggetto ForEachEnumerator.
- variableDispenser
- VariableDispenser
Oggetto VariableDispenser per il blocco di variabili.
- infoEvents
- IDTSInfoEvents
Oggetto che implementa l'interfaccia IDTSInfoEvents.
- log
- IDTSLogging
Oggetto che implementa l'interfaccia IDTSLogging.
Restituisce
Enumerazione DTSExecResult che indica il risultato della convalida.
Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come convalidare gli 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 esamina le proprietà e le impostazioni per le inesattezze o le impostazioni non corrette. Il metodo non tocca i dati o 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'uso principale di Validate
è quando si scrive un'attività personalizzata. Il Validate
metodo viene chiamato dal Designer SSIS quando un'attività viene rilasciata nell'area di progettazione e di nuovo, potenzialmente più volte, quando vengono impostate le proprietà. Tuttavia, nel codice, il Validate
metodo su singoli oggetti non viene comunemente usato, perché è consigliabile chiamare il Validate
metodo su Package quando è necessario convalidare gli oggetti. Tuttavia, il metodo è disponibile su singoli oggetti se si trova una circostanza univoca in cui è necessaria.
Il Validate
metodo viene sottoposto a override nelle attività personalizzate, per la convalida dell'oggetto quando viene usato nel Designer 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.