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::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 DTSValidationStatusDevoluciones
Un valor de la enumeración DTSValidationStatus 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 la Validación.
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 objetos IDTSInput100 e IDTSOutput100.
Verifica que cualquier objeto IDTSCustomProperty100 continúe existiendo y contenga los valores correctos.
Verifica que cada objeto IDTSInputColumn100 en su IDTSInputColumnCollection100 haga referencia a un objeto IDTSOutputColumn100 existente en un componente ascendente.
Si el componente utiliza una conexión, verifica que el IDTSRuntimeConnection100 esté especificado y que el ConnectionManager existe en el paquete.
Los componentes deben proporcionar retroalimentación a los usuarios cuando falla la validación. La retroalimentación se proporciona mediante los métodos FireError y FireWarning y mediante el valor de retorno DTSValidationStatus. Las llamadas a los métodos FireError y FireWarning se muestran en la ventana de la Lista de Tareas en SQL Server Data Tools (SSDT), y deben proporcionar orientación a los usuarios sobre el fallo de validación. De los cuatro valores en la enumeración DTSValidationStatus, 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 en el ComponentMetaData para resolver los problemas. |
| VS_NEEDSNEWMETADATA | Indica que los errores de validación pueden corregirse mediante el componente en su implementación del método ReinitializeMetaData. 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 método ReinitializeMetaData. |
| VS_ISCORRUPT | Indica que el ComponentMetaData está corrupto y no puede repararse mediante una llamada al método ReinitializeMetaData ni mediante ediciones en el componente. |
Cuando la propiedad de DelayValidation 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.