IDTSForEachEnumerator.Validate Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Permite que o ForEachEnumerator determine se ele contém configurações inválidas que o impedirão de ser executado com êxito.

public:
 Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult

Parâmetros

connections

Connections

Uma coleção de conexões usada pelo ForEachEnumerator.

variableDispenser

VariableDispenser

Um objeto VariableDispenser para variáveis de bloqueio.

infoEvents

IDTSInfoEvents

Um objeto que implementa a interface do IDTSInfoEvents.

log

IDTSLogging

Um objeto que implementa a interface do 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 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.