CManagedComponentWrapperClass.Validate Method

Definition

Verifies that the component is configured correctly and ready to execute.

public:
 virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate() = Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSDesigntimeComponent100::Validate;
[System.Runtime.InteropServices.DispId(29)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();
[<System.Runtime.InteropServices.DispId(29)>]
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

Returns

A value from the DTSValidationStatus enumeration.

Implements

Attributes

Remarks

The Validate method of a component is always called by the data flow task prior to execution. However this method can be called at any time. When the method is called, the component will check the configuration of its inputs, outputs, custom properties, and column collections to verify that the component is properly configured. Most components will raise OnError and OnWarning events when validation errors occur. These events provide additional information on the problems with the component.

The following table describes the error values of the DTSValidationStatus enumeration.

Status Description
VS_ISBROKEN Indicates that the component is not configured correctly, but that it can be repaired by modifying properties of the component.
VS_NEEDSNEWMETADATA Indicates that the validation errors can be fixed by the component in the ReinitializeMetaData method.
VS_ISCORRUPT Indicates that the ComponentMetaData is corrupt and cannot be repaired by a call to ReinitializeMetaData or by edits to the component. This is typically caused by editing the package XML directly.

Applies to