PipelineComponent.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í.
Importante
Esta API no es conforme a CLS.
Comprueba si el componente está configurado correctamente.
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 DTSValidationStatusDevoluciones
Un valor de la enumeración DTSValidationStatus que indica el estado del componente.
- Atributos
Comentarios
Los desarrolladores de componentes reemplazan 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 ComponentMetaData durante Validate.
La implementación de la clase base de Validate comprueba la existencia de IDTSInputColumn100 objetos cuya LineageID propiedad no coincide con el LineageID de un IDTSOutputColumn100 componente ascendente. Los desarrolladores de componentes deben ampliar la funcionalidad de clase Validate base realizando comprobaciones adicionales en .ComponentMetaData 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.
Si el componente usa una conexión, debe comprobar 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 FireError y FireWarning se muestran en la ventana Lista de errores de SQL Server Data Tools (SSDT) y deben proporcionar instrucciones a los usuarios sobre el error de validación. De los cuatro valores de la DTSValidationStatus enumeración, solo VS_ISVALID indica una validación correcta. 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 los interpreta el Diseñador de SSIS.
| Estado | Descripción |
|---|---|
| VS_ISBROKEN | Indica que el componente no está configurado incorrectamente, pero que el usuario va a 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 VS_NEEDSNEWMETADATAse llame a y, posteriormente ReinitializeMetaData , se llame a . |
| VS_ISCORRUPT | Indica que está ComponentMetaData dañado y no se puede reparar mediante una llamada a ReinitializeMetaData 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 a Validate y se llama al método antes de la ejecución del componente.
Para obtener más información, vea Validating a Data Flow Component (Validación de un componente de flujo de datos).