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 verificare 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
Interfaccia IDTSInfoEvents utilizzata per generare eventi informativi durante l'esecuzione del pacchetto.
Restituisce
Valore della struttura DTSExecResult che indica l'esito positivo o negativo della convalida.
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. Per i provider di log, il Validate metodo verifica che la ConfigString proprietà sia configurata correttamente e che tutte le altre proprietà o impostazioni necessarie per il provider di log siano impostate come previsto. I provider di log che richiedono connessioni a origini dati esterne eseguono questa operazione tramite l'uso di ConnectionManager oggetti . La ConfigString proprietà viene spesso utilizzata per contenere il nome o l'ID di un ConnectionManager oggetto nella Connections raccolta.
In questo caso, Validate verificare che l'oggetto ConnectionManagerConfigString specificato nella proprietà esista nel pacchetto.
Se Failure viene restituito, l'esecuzione del pacchetto viene annullata.
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.