Compartir a través de


PipelineComponent.Validate Método

Definición

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.DTSValidationStatus
Public Overridable Function Validate () As DTSValidationStatus

Devoluciones

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.

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).

Se aplica a