PipelineComponent.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.
Importante
Esta API não está em conformidade com CLS.
Verifica se o componente está configurado corretamente.
public:
virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Overridable Function Validate () As DTSValidationStatusRetornos
Um valor da enumeração DTSValidationStatus que indica o status do componente.
- Atributos
Comentários
O Validate método é substituído 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 ComponentMetaData durante Validate.
A implementação da classe base de Validate verificações sobre a existência de IDTSInputColumn100 objetos cuja LineageID propriedade não corresponde à LineageID de um IDTSOutputColumn100 componente upstream. Os desenvolvedores de componentes devem estender a funcionalidade da classe Validate base executando verificações adicionais no ComponentMetaData. 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.
Se o componente usa uma conexão, ele deve verificar se o IDTSRuntimeConnection100 é especificado e se ele 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 são exibidas e exibidas na janela Lista de Erros no SQL Server Data Tools (SSDT) e devem fornecer orientação aos usuários sobre a falha de validação.FireErrorFireWarning 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 incorretamente, mas é alterado pelo usuário para resolver os ComponentMetaData 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 VS_NEEDSNEWMETADATAe, posteriormente ReinitializeMetaData , for chamado. |
| VS_ISCORRUPT | Indica que o ComponentMetaData componente está corrompido e não pode ser reparado por uma chamada ou ReinitializeMetaData por edições no componente. |
Quando a DelayValidation propriedade da tarefa de fluxo de dados é true, as chamadas de tempo de design são Validate eliminadas e o método é chamado antes da execução do componente.
Para obter mais informações, consulte Validando um componente de fluxo de dados.