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í.
Comprueba si el componente está configurado correctamente.
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 DTSValidationStatusDevoluciones
Un valor de la enumeración DTSValidationStatus que indica el estado del componente.
- Atributos
Comentarios
Los desarrolladores de componentes implementan el Validate método para comprobar que el componente está configurado correctamente. Se llama repetidamente durante el diseño del paquete y una vez antes de la ejecución del componente. Los componentes no deben modificar su IDTSComponentMetaData100 durante Validate.
Cada componente tiene requisitos diferentes para la validación correcta, pero en la lista siguiente se proporcionan algunos de los elementos comunes que se deben validar.
Compruebe que el componente tiene el número esperado de IDTSInput100 objetos y IDTSOutput100 .
Compruebe que los IDTSCustomProperty100 objetos sigan existiendo y contengan los valores correctos.
Compruebe que cada IDTSInputColumn100 objeto de sus IDTSInputColumnCollection100 referencias a un objeto existente IDTSOutputColumn100 en un componente ascendente.
Si el componente usa una conexión, compruebe que IDTSRuntimeConnection100 se especifica y que ConnectionManager existe en el paquete.
Los componentes deben proporcionar comentarios a los usuarios cuando se produce un error en la validación. Los comentarios se proporcionan a través de los FireError métodos y FireWarning y por el DTSValidationStatus valor devuelto. Las llamadas a los FireError métodos y FireWarning se muestran en la ventana Lista de tareas de SQL Server Data Tools (SSDT) y deben proporcionar a los usuarios instrucciones sobre el error de validación. De los cuatro valores de la DTSValidationStatus enumeración, solo VS_ISVALID indica que la validación se ha realizado correctamente. Los otros tres valores indican distintos niveles de error. En la tabla siguiente se describen los valores de error de la enumeración y cómo se interpretan mediante el Diseñador de SSIS.
| Estado | Descripción |
|---|---|
| VS_ISBROKEN | Indica que el componente no está configurado correctamente. El usuario debe realizar cambios en para ComponentMetaData resolver los problemas. |
| VS_NEEDSNEWMETADATA | Indica que el componente puede corregir los errores de validación en su implementación del ReinitializeMetaData método . El diseñador de SSIS solicitará a los usuarios que el componente pueda repararse cuando el valor de enumeración sea VS_NEEDSNEWMETADATA. A continuación, el diseñador llamará al ReinitializeMetaData método . |
| VS_ISCORRUPT | Indica que está ComponentMetaData dañado y no se puede reparar 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 true, se eliminan las llamadas en tiempo de diseño al Validate método y se llama al método antes de la ejecución del componente en su lugar.