MessageQueueTask.Validate Método

Definição

Verifica se a tarefa está configurada corretamente.

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

Parâmetros

connections
Connections

Uma coleção de conexões usada pela tarefa.

variableDispenser
VariableDispenser

Um objeto VariableDispenser para variáveis de bloqueio.

events
IDTSComponentEvents

Um objeto que implementa a interface IDTSComponentEvents.

log
IDTSLogging

Um objeto que implementa a interface IDTSLogging.

Retornos

DTSExecResult

Um valor da enumeração DTSExecResult.

Exemplos

O exemplo de código a seguir mostra como validar objetos usando o Validate método do Package objeto.

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);  
Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)  

Comentários

O Validate método revisa as propriedades e configurações para imprecisões ou configurações incorretas. O método não toca dados ou se conecta a fontes de dados para validar conexões. No entanto, ele garante que os campos obrigatórios sejam preenchidos e contenham valores apropriados. Os campos que são validados diferem de acordo com o objeto que está sendo validado.

O uso principal do Validate é ao gravar uma tarefa personalizada. O Validate método é chamado pelo designer do SSIS quando uma tarefa é descartada na superfície de design e novamente, potencialmente várias vezes, quando as propriedades estão sendo definidas. No entanto, no código, o Validate método em objetos individuais não é usado normalmente, pois é recomendável que você chame o Validate método no Package quando precisar validar objetos. No entanto, o método está disponível em objetos individuais se você encontrar uma circunstância exclusiva onde for necessário.

O Validate método é substituído em tarefas personalizadas, seja para validação do objeto quando usado no Designer SSIS ou quando chamado pelo código. Para obter mais informações sobre como escrever o Validate método para uma tarefa personalizada, consulte codificando uma tarefa personalizada.

Aplica-se a