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.
Verifica se o componente está configurado corretamente.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatusRetornos
Um valor da enumeração DTSValidationStatus que indica o status do componente.
- Atributos
Comentários
O Validate método é 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 o seu IDTSComponentMetaData100 durante Validate.
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 IDTSInput100 objetos e IDTSOutput100 objetos.
Verifique se todos os IDTSCustomProperty100 objetos continuam existindo e contenham os valores corretos.
Verifique se cada IDTSInputColumn100 objeto em suas IDTSInputColumnCollection100 referências a um objeto existente IDTSOutputColumn100 em um componente upstream.
Se o componente usa uma conexão, verifique se a IDTSRuntimeConnection100 especificação está especificada e se ela 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 FireError métodos e FireWarning pelo DTSValidationStatus valor retornado. As chamadas e os FireErrorFireWarning métodos são exibidos na janela Lista de Tarefas no SQL Server Data Tools (SSDT) e devem fornecer orientação aos usuários sobre a falha de validação. Dos quatro valores na DTSValidationStatus enumeração, indica apenas VS_ISVALID a validação bem-sucedida. Os outros três valores indicam níveis diferentes 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 para ComponentMetaData resolver os problemas. |
| VS_NEEDSNEWMETADATA | Indica que os erros de validação podem ser corrigidos pelo componente em sua implementação do ReinitializeMetaData método. 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 ReinitializeMetaData método. |
| VS_ISCORRUPT | Indica que o ComponentMetaData componente está corrompido e não pode ser reparado por uma chamada ao ReinitializeMetaData método ou por edições para o componente. |
Quando a DelayValidation propriedade da tarefa de fluxo de dados é true, as chamadas de tempo de design para o Validate método são eliminadas e o método é chamado antes da execução do componente.