IDTSDesigntimeComponent100.Validate 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.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2012::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRetornos
Um valor da enumeração DTSValidationStatus que indica o status do componente.
- Atributos
Comentários
O método Validate é implementado por desenvolvedores de componentes para verificar se o componente está configurado corretamente. Ele é chamado repetidamente durante o design do pacote e uma vez antes da execução do componente. Os componentes não devem modificar seu IDTSComponentMetaData100 durante Validar.
Cada componente tem requisitos diferentes para validação bem-sucedida, mas a lista a seguir fornece alguns dos itens comuns que devem ser validados.
Verifique se o componente tem o número esperado de objetos IDTSInput100 e IDTSOutput100.
Verifique se todos os objetos IDTSCustomProperty100 continuam existindo e contêm os valores corretos.
Verifique se cada objeto IDTSInputColumn100 em seu objeto IDTSInputColumnCollection100 faz referência a um objeto IDTSOutputColumn100 existente em um componente upstream.
Se o componente usar uma conexão, verifique se o IDTSRuntimeConnection100 foi especificado e se o ConnectionManager existe no pacote.
Os componentes devem fornecer comentários aos usuários quando a validação falhar. Os comentários são fornecidos por meio dos métodos FireError e FireWarning e pelo valor retornado DTSValidationStatus. As chamadas para os métodos FireError e FireWarning são exibidas na janela Lista de Tarefas no SQL Server Data Tools (SSDT) e devem fornecer aos usuários diretrizes sobre a falha de validação. Dos quatro valores na enumeração DTSValidationStatus, apenas VS_ISVALID indica validação bem-sucedida. Os outros três valores indicam diferentes níveis de falha. A tabela a seguir descreve os valores de falha na enumeração e como eles são interpretados pelo Designer do SSIS.
| Status | Descrição |
|---|---|
| VS_ISBROKEN | Indica que o componente não está configurado corretamente. O usuário deve fazer alterações no ComponentMetaData para resolver os problemas. |
| VS_NEEDSNEWMETADATA | Indica que os erros de validação podem ser corrigidos pelo componente em sua implementação do método ReinitializeMetaData. O designer do SSIS solicitará aos usuários que o componente possa se reparar quando o valor de enumeração for VS_NEEDSNEWMETADATA. Em seguida, o designer chamará o método ReinitializeMetaData. |
| VS_ISCORRUPT | Indica que ComponentMetaData está corrompido e não pode ser reparado por uma chamada para o método ReinitializeMetaData ou por edições para o componente. |
Quando a propriedade DelayValidation da tarefa de fluxo de dados é verdadeira, as chamadas em tempo de design para o método Validate são eliminadas e o método é chamado antes da execução do componente.