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 Validar é implementado por desenvolvedores de componentes para verificar se o componente está corretamente configurado. Ele é chamado repetidamente durante o projeto do pacote e uma vez antes da execução do componente. Os componentes não devem modificar seu IDTSComponentMetaData100 durante a Validação.
Cada componente tem requisitos diferentes para validação bem-sucedida, mas a lista a seguir apresenta alguns dos itens comuns que devem ser validados.
Verifique se o componente possui o número esperado de objetos IDTSInput100 e IDTSOutput100.
Verifique se quaisquer objetos IDTSCustomProperty100 continuam existindo e contêm os valores corretos.
Verifique se cada objeto IDTSInputColumn100 em seu IDTSInputColumnCollection100 faz referência a um objeto IDTSOutputColumn100 existente em um componente upstream.
Se o componente usar uma conexão, verifique se o IDTSRuntimeConnection100 está especificado e se o ConnectionManager existe no pacote.
Os componentes devem fornecer feedback aos usuários quando a validação falhar. O feedback é fornecido por meio dos métodos FireError e FireWarning e pelo valor de retorno DTSValidationStatus. Chamadas para os métodos FireError e FireWarning são exibidas na janela da 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 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 SSIS Designer.
| Status | Description |
|---|---|
| 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 projetista do SSIS avisará os usuários de que o componente pode se reparar sozinho quando o valor da enumeração for VS_NEEDSNEWMETADATA. Depois, o designer chamará o método ReinitializeMetaData. |
| VS_ISCORRUPT | Indica que o ComponentMetaData está corrompido e não pode ser reparado por uma chamada ao método ReinitializeMetaData ou por edições no componente. |
Quando a propriedade DelayValidation da tarefa de fluxo de dados é verdadeira, chamadas em tempo de projeto para o método Validar são eliminadas, e o método é chamado antes da execução do componente.