IDTSDesigntimeComponent100.Validate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatus Validate();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatusPublic Function Validate () As DTSValidationStatusDevoluciones
Un valor de la DTSValidationStatus enumeración que indica el estado del componente.
- Atributos
Comentarios
El método Validar es implementado por desarrolladores de componentes para verificar que el componente está correctamente configurado. Se llama repetidamente durante el diseño del encapsulado y una vez antes de la ejecución del componente. Los componentes no deben modificar su IDTSComponentMetaData100 durante Validate.
Cada componente tiene diferentes requisitos para una validación exitosa, pero la siguiente lista proporciona algunos de los elementos comunes que deben validarse.
Verifica que el componente tenga el número esperado de IDTSInput100 objetos y (y IDTSOutput100 objetos).
Verifica que los IDTSCustomProperty100 objetos sigan existiendo y contengan los valores correctos.
Verifica que cada objeto IDTSInputColumn100 en su IDTSInputColumnCollection100 archivo hace referencia a un objeto existente IDTSOutputColumn100 en un componente upstream.
Si el componente utiliza una conexión, verifica que el IDTSRuntimeConnection100 esté especificado y que existe ConnectionManager en el encapsulado.
Los componentes deben proporcionar retroalimentación a los usuarios cuando falla la validación. La retroalimentación se proporciona a través de los FireError métodos y FireWarning mediante el valor de DTSValidationStatus retorno. Las llamadas a los FireError métodos y FireWarning se muestran en la ventana de Lista de tareas en SQL Server Data Tools (SSDT), y deberían proporcionar orientación a los usuarios sobre el fallo de validación. De los cuatro valores de la DTSValidationStatus enumeración, solo VS_ISVALID indica validación exitosa. Los otros tres valores indican diferentes niveles de fallo. La siguiente tabla describe los valores de fallo en la enumeración y cómo son interpretados por SSIS Designer.
| Situación | Descripción |
|---|---|
| VS_ISBROKEN | Indica que el componente no está configurado correctamente. El usuario debe realizar cambios para ComponentMetaData resolver los problemas. |
| VS_NEEDSNEWMETADATA | Indica que los errores de validación pueden ser corregidos por el componente en su implementación del ReinitializeMetaData método. El diseñador del SSIS indicará a los usuarios que el componente puede repararse a sí mismo cuando el valor de enumeración esté VS_NEEDSNEWMETADATA. Luego el diseñador llamará al ReinitializeMetaData método. |
| VS_ISCORRUPT | Indica que está ComponentMetaData corrompido y no puede repararse mediante una llamada al ReinitializeMetaData método o mediante modificaciones en el componente. |
Cuando la DelayValidation propiedad de la tarea de flujo de datos es cierta, se eliminan las llamadas en tiempo de diseño al método Validar y el método se llama antes de la ejecución del componente.