ConnectionManagerBase.Validate(IDTSInfoEvents) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Valida a conexão e retorna uma enumeração que indica êxito ou falha.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents);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 (infoEvents As IDTSInfoEvents) As DTSExecResultParâmetros
- infoEvents
- IDTSInfoEvents
Um objeto que implementa a interface de eventos IDTSInfoEvents para gerar erros, avisos ou eventos informativos.
Retornos
Uma 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 examina propriedades e configurações para imprecisões ou configurações incorretas. O método não toca em dados ou se conecta a fontes de dados para validar conexões. No entanto, ele garante que os campos necessários sejam preenchidos e contenham valores apropriados. Os campos validados diferem dependendo de qual objeto está sendo validado.
O uso Validate principal é ao escrever 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 é comumente usado, pois é recomendável que você chame o Validate método no momento em Package que você precisa validar objetos. No entanto, o método está disponível em objetos individuais caso você encontre uma circunstância exclusiva onde ele é necessário.
O Validate método é substituído em tarefas personalizadas, seja para validação do objeto quando usado no Designer do SSIS ou quando chamado por código. Para obter mais informações sobre como escrever o Validate método para uma tarefa personalizada, consulte Codificando uma tarefa personalizada.