ForEachEnumerator.Validate Método

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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.

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

public:
 virtual 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 virtual 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
override this.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 Overridable Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult

Parâmetros

connections: Connections

A coleção Connections do ForEachEnumerator.

variableDispenser: VariableDispenser

A coleção Variables do contêiner.

infoEvents: IDTSInfoEvents

Um objeto que implementa a interface IDTSInfoEvents de eventos (erros, avisos, etc.) acionados durante a persistência.

log: IDTSLogging

Uma interface IDTSLogging.

Retornos

DTSExecResult

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

Implementações

Validate(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging)

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.

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

Compartilhar via