Task.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.
Verifica che il componente sia configurato correttamente.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ componentEvents, 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.IDTSComponentEvents componentEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * 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.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overridable Function Validate (connections As Connections, variableDispenser As VariableDispenser, componentEvents As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult
Parametri
- connections
- Connections
Una raccolta di connessioni utilizzate per il compito.
- variableDispenser
- VariableDispenser
Un VariableDispenser oggetto per variabili di blocco.
- componentEvents
- IDTSComponentEvents
Oggetto che implementa l'interfaccia IDTSComponentEvents .
- log
- IDTSLogging
Oggetto che implementa l'interfaccia IDTSLogging .
Valori restituiti
Valore dell'enumerazione DTSExecResult .
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.