LogProviderBase.Validate(IDTSInfoEvents) 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.
Chiamato per confermare che il provider di log sia configurato correttamente.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultParametri
- events
- IDTSInfoEvents
Un'interfaccia utilizzata per lanciare eventi informativi durante l'esecuzione del IDTSInfoEvents pacchetto.
Valori restituiti
Un valore della DTSExecResult struttura che indica il successo o il fallimento della validazione.
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. Per i provider di log, il Validate metodo verifica che la ConfigString proprietà sia correttamente configurata e che tutte le altre proprietà o impostazioni richieste dal provider di log siano impostate come previsto. I provider di log che richiedono connessioni a fonti di dati esterne lo fanno tramite l'uso di ConnectionManager oggetti. La ConfigString proprietà viene spesso utilizzata per contenere il nome o l'ID di una ConnectionManager persona nella Connections collezione.
In questo caso, Validate dovrebbe verificare che ciò ConnectionManager specificato nella ConfigString proprietà esista nel pacchetto.
Se Failure viene restituito, l'esecuzione del pacchetto viene annullata.
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.