LogProviderBase.Validate(IDTSInfoEvents) Método

Definição

Chamado para confirmar se o provedor de log está configurado corretamente.

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.DTSExecResult
Public Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResult

Parâmetros

events
IDTSInfoEvents

Uma interface IDTSInfoEvents usada para disparar eventos informativos durante a execução do pacote.

Retornos

DTSExecResult

Um valor da estrutura DTSExecResult que indica o sucesso ou a falha da validação.

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 nem 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. Para provedores de log, o Validate método verifica se a ConfigString propriedade está configurada corretamente e quaisquer outras propriedades ou configurações necessárias do provedor de log são definidas conforme o esperado. Provedores de log que exigem conexões com fontes de dados externas fazem isso por meio do uso de ConnectionManager objetos. A ConfigString propriedade geralmente é usada para conter o nome ou a ID de um ConnectionManager na Connections coleção.

Nesse caso, Validate verifique se o ConnectionManager especificado na ConfigString propriedade existe no pacote.

Se Failure for retornado, a execução do pacote será cancelada.

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 quando Package precisar validar objetos. No entanto, o método está disponível em objetos individuais caso você encontre uma circunstância exclusiva em que ele é 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 por 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