Executable.Validate(Connections, Variables, IDTSEvents, 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.
Verifica che il file eseguibile venga eseguito correttamente convalidando tutte le relative dipendenze e gli altri elementi prima dell'esecuzione. Il componente che implementa questo metodo è il componente che verrà convalidato.
public:
abstract Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::Variables ^ variables, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public abstract Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.Variables variables, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.Variables * Microsoft.SqlServer.Dts.Runtime.IDTSEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResult
Parametri
- connections
- Connections
Raccolta Connections.
- events
- IDTSEvents
Interfaccia IDTSEvents per la generazione di eventi.
- log
- IDTSLogging
Interfaccia di IDTSLogging.
Restituisce
Restituisce un valore dell'enumerazione DTSExecResult che indica l'esito positivo, l'esito negativo o un altro stato restituito dalla convalida del file eseguibile.
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.