Executable.Validate(Connections, Variables, IDTSEvents, IDTSLogging) 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.
Verifique se o executável será executado com êxito validando todas as suas dependências e outros itens antes da execução. O componente que implementa este método é o componente que está sendo validado.
public:
abstract Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::Variables ^ variables, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);public abstract Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.Variables variables, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.Variables * Microsoft.SqlServer.Dts.Runtime.IDTSEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResultParâmetros
- connections
- Connections
Uma coleção de Connections.
- events
- IDTSEvents
Uma interface IDTSEvents para geração de eventos.
- log
- IDTSLogging
Uma interface IDTSLogging.
Retornos
Retorna um valor da enumeração DTSExecResult que indica o sucesso, a falha ou outro status da validação do executável.
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.