TransferDatabaseTask.Validate Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Tasks.TransferDatabaseTask

Assembly:

Microsoft.SqlServer.TransferDatabasesTask.dll

Verifica che il componente dell'attività sia configurato correttamente.

public:
 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

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 Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult

Parametri

connections

Connections

Raccolta di connessioni utilizzate dall'attività.

variableDispenser

VariableDispenser

Oggetto VariableDispenser per il blocco di variabili.

events

IDTSComponentEvents

Oggetto che implementa l'interfaccia IDTSComponentEvents.

log

IDTSLogging

Oggetto che implementa l'interfaccia IDTSLogging.

Restituisce

DTSExecResult

Valore ricavato dall'enumerazione DTSExecResult.

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 sui singoli oggetti non viene comunemente usato. È invece necessario 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.